@adminide-stack/yantra-help-browser 12.0.16-alpha.6 → 12.0.16

package/lib/templates/content/blog/introducing-yantra-browser.md

@@ -0,0 +1,90 @@
+---
+title: 'Introducing Yantra Browser: Your AI-Powered Browser Automation Companion'
+description: 'Meet Yantra Browser — a Chrome extension that turns your browser into an AI-powered automation tool, combining the power of your local browser with intelligent cloud AI.'
+author: 'Yantra Team'
+date: '2025-03-21'
+category: 'Product'
+tags: ['browser-extension', 'automation', 'chrome', 'ai', 'launch']
+coverImage: '/static/img/blog/yantra-browser-launch.png'
+readTime: '6 min read'
+slug: 'introducing-yantra-browser'
+---
+
+# Introducing Yantra Browser: Your AI-Powered Browser Automation Companion
+
+We're thrilled to announce **Yantra Browser** — a Chrome extension that transforms your everyday browser into an AI-powered automation powerhouse. Whether you're researching, managing emails, filling forms, or extracting data, Yantra Browser works alongside you to get things done faster and smarter.
+
+## Two Environments, One Unified Experience
+
+Yantra operates in two distinct but seamlessly connected environments:
+
+| Environment      | Description                                                                                                                                                    |
+| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Your Browser** | The Chrome extension lives in your local browser, where you browse, shop, and work every day. It sees what you see and can interact with pages on your behalf. |
+| **Cloud AI**     | Yantra's AI assistant runs in the cloud, analyzing context, making decisions, and orchestrating multi-step workflows with enterprise-grade reliability.        |
+
+This dual-environment approach means you get the best of both worlds: the trust and familiarity of your own browser combined with the intelligence and scale of cloud-based AI.
+
+## The Local Advantage
+
+Unlike fully cloud-based browser automation tools, Yantra Browser runs directly on your machine. This gives you several key advantages:
+
+-   **Your Trusted Identity** — Websites see your real browser fingerprint and logged-in sessions. No CAPTCHAs, no bot detection, no blocked requests.
+-   **Your IP Address** — Requests come from your actual network, not a data center. Geo-restricted content just works.
+-   **Your Extensions** — Ad blockers, password managers, and other extensions you rely on continue to work seamlessly alongside Yantra.
+-   **Your Data Stays Local** — Page content is processed locally first. Only the minimal context needed for AI decisions leaves your machine.
+
+## Full Automation for Real Workflows
+
+Yantra Browser isn't just a page reader — it's a full automation agent capable of executing complex, multi-step workflows:
+
+-   **Research & Data Collection** — Automatically gather information across dozens of tabs, compile findings, and generate summaries.
+-   **Email & Communication** — Draft replies, schedule follow-ups, and manage your inbox with AI-assisted triage.
+-   **Form Filling & Data Entry** — Complete repetitive forms across CRM systems, HR platforms, and admin portals.
+-   **E-commerce & Price Monitoring** — Track prices, compare products, and receive alerts when deals match your criteria.
+-   **Content Management** — Publish blog posts, update CMS entries, and manage social media queues.
+
+## How It Works
+
+Getting started takes less than a minute:
+
+1. **Install the Extension** — Add Yantra Browser from the Chrome Web Store. It integrates quietly into your browser toolbar.
+2. **Connect Your Account** — Sign in with your Yantra account. The extension auto-detects your workspace or you can connect manually with a pairing code.
+3. **Start Automating** — Give natural-language instructions to your Yantra AI assistant. Watch as it navigates, clicks, types, and extracts data in your browser — all while you stay in control.
+
+## Transparency and Control
+
+Every action Yantra takes is visible and reversible:
+
+-   **Action Feed** — See a real-time log of every click, navigation, and data extraction.
+-   **Pause & Resume** — Halt automation at any point, make manual adjustments, and let the AI continue.
+-   **Permission Boundaries** — You control which sites the extension can interact with and what types of actions are allowed.
+-   **No Remote Code** — The extension runs only bundled code. No scripts are downloaded or executed from external servers at runtime.
+
+## Built on Chrome DevTools Protocol
+
+Under the hood, Yantra Browser uses the Chrome DevTools Protocol (CDP) — the same technology that powers Chrome's built-in developer tools. This means:
+
+-   **Precise DOM Interaction** — Accurate element targeting without fragile CSS selectors or XPath hacks.
+-   **Network Awareness** — Monitor API calls, intercept responses, and understand page behavior in real time.
+-   **JavaScript Execution** — Run safe, sandboxed scripts to extract data or trigger UI interactions.
+-   **Performance Profiling** — Identify slow pages and optimize your automation workflows.
+
+## Privacy First
+
+We take your privacy seriously. The Yantra Browser extension:
+
+-   Collects **no browsing history**
+-   Stores **no passwords or credentials**
+-   Transmits **no personal data** without your explicit action
+-   Operates under a strict [Privacy Policy](/privacy) with full transparency about data handling
+
+## Available Now
+
+Yantra Browser is available today on the Chrome Web Store for all Yantra users. Whether you're on the Free, Pro, or Enterprise plan, you can install and start using the extension immediately.
+
+[Install Yantra Browser →](https://chromewebstore.google.com/detail/yantra-browser)
+
+---
+
+_Have questions or feedback? Reach out to us at [support@yantra.app](mailto:support@yantra.app) or join our [Community](/community)._

package/lib/templates/content/blog/yantra-browser-productivity-tips.md

@@ -0,0 +1,98 @@
+---
+title: '5 Ways Yantra Browser Supercharges Your Productivity'
+description: 'Discover practical workflows where Yantra Browser saves hours of manual work — from research to data entry to inbox management.'
+author: 'Yantra Team'
+date: '2025-03-22'
+category: 'Productivity'
+tags: ['browser-extension', 'productivity', 'workflows', 'use-cases', 'tips']
+coverImage: '/static/img/blog/yantra-browser-productivity.png'
+readTime: '5 min read'
+slug: 'yantra-browser-productivity-tips'
+---
+
+# 5 Ways Yantra Browser Supercharges Your Productivity
+
+You've installed Yantra Browser. Your account is connected. Now what? Here are five high-impact workflows where the extension delivers immediate, measurable productivity gains.
+
+## 1. Research That Writes Itself
+
+**The old way:** Open 15 tabs, skim articles, copy-paste relevant quotes into a document, lose track of sources, spend 2 hours on a report that should take 30 minutes.
+
+**The Yantra way:** Tell the AI assistant "Research the top 5 project management tools for remote teams and create a comparison summary." Yantra Browser:
+
+-   Opens authoritative review sites and product pages
+-   Extracts feature lists, pricing, and user ratings
+-   Cross-references multiple sources for accuracy
+-   Generates a structured comparison document with source links
+
+**Time saved:** ~90 minutes per research session
+
+## 2. Inbox Zero on Autopilot
+
+**The old way:** Open every email, decide what to do, compose replies, file messages, flag follow-ups. Repeat 100 times a day.
+
+**The Yantra way:** "Triage my inbox — reply to scheduling requests with my available times this week, flag anything from leadership as high priority, and archive all newsletters."
+
+Yantra Browser navigates your email client, reads conversation threads, drafts contextual replies for your review, and organizes messages — all within your existing mail interface.
+
+**Time saved:** ~45 minutes per day
+
+## 3. Form Filling Without the Pain
+
+**The old way:** Copy-paste the same company information into 12 different vendor portals. Re-enter employee details across HR systems. Manually update CRM records one by one.
+
+**The Yantra way:** "Fill out the vendor registration form on acme.com using our standard company details." Or: "Update all 50 leads in Salesforce with the new territory assignments from this spreadsheet."
+
+The extension navigates to forms, fills fields accurately, handles dropdowns and checkboxes, and even manages multi-page registration flows.
+
+**Time saved:** ~2 hours per batch of form fills
+
+## 4. Competitive Intelligence on Demand
+
+**The old way:** Manually check competitor websites weekly, take screenshots, note pricing changes, compare feature updates, compile everything in a slide deck.
+
+**The Yantra way:** "Monitor competitor pricing pages for TechCorp, DataCo, and CloudBase. Alert me to any changes and compile a weekly summary."
+
+Yantra Browser visits target pages on schedule, extracts pricing and feature data, compares against previous snapshots, and surfaces meaningful changes — all using your local browser so there's no IP blocking or CAPTCHA interference.
+
+**Time saved:** ~3 hours per week
+
+## 5. Data Extraction Without Code
+
+**The old way:** Write a web scraper, handle pagination, deal with anti-bot measures, parse HTML, clean data, load into a spreadsheet. Debug when the site layout changes.
+
+**The Yantra way:** "Extract all product listings from this search results page — name, price, rating, and link — and organize them in a table."
+
+Because Yantra Browser runs in your actual Chrome session, it handles JavaScript-rendered content, login-gated pages, and infinite scroll naturally. No separate scraping infrastructure needed.
+
+**Time saved:** ~4 hours per extraction project
+
+## Getting the Most Out of Yantra Browser
+
+A few tips to maximize your automation efficiency:
+
+### Be Specific in Your Instructions
+
+Instead of "help me with email," try "reply to the last 3 unread emails from @company.com with a brief acknowledgment." The more context you provide, the better the AI performs.
+
+### Start with Low-Risk Tasks
+
+Begin with read-only operations like research and data extraction. As you build confidence, move to actions like form filling and email replies.
+
+### Use the Action Feed
+
+Watch the real-time action feed in the extension popup to understand what Yantra is doing. This builds intuition for what kinds of tasks work best.
+
+### Combine with Yantra's Cloud AI
+
+The browser extension is most powerful when paired with Yantra's full AI assistant. Use the extension for web interactions and the assistant for analysis, writing, and decision-making.
+
+## Start Saving Time Today
+
+Every workflow above is available right now with Yantra Browser. Install the extension, connect your account, and give one of these scenarios a try.
+
+[Install Yantra Browser →](https://chromewebstore.google.com/detail/yantra-browser)
+
+---
+
+_What workflows are you automating with Yantra Browser? Share your use cases in our [Community](/community) — we feature the best ones in our monthly showcase._

package/lib/templates/content/browser-extension/browser-extension-overview.md

@@ -0,0 +1,60 @@
+---
+title: 'Browser Extension Overview'
+description: 'What the Yantra Browser extension is and how it transforms your browser into an AI-powered automation tool'
+author: 'Yantra Team'
+---
+
+# Yantra Browser Extension
+
+The Yantra Browser extension transforms your web browser from a passive viewing tool into an active, intelligent agent. It allows Yantra to operate directly within your local browser environment — securely taking action within your pages, executing complex tasks as if you were doing them yourself.
+
+## What It Is
+
+Yantra Browser is a Chrome extension that bridges your local browser with the Yantra AI assistant. When you give Yantra a task that requires web interaction — filling out forms, researching across multiple tabs, managing emails, or completing online purchases — the extension handles the execution directly in your browser.
+
+Unlike cloud-only automation, the Yantra Browser extension operates within your existing browser session. Your logins stay active, your cookies remain intact, and websites see activity from your trusted local IP address. This means no CAPTCHAs, no re-authentication, and no session interruptions.
+
+## Two Environments, One Unified Experience
+
+Yantra operates through two complementary environments:
+
+| Feature            | Local Browser (Extension)                             | Cloud Browser                                  |
+| ------------------ | ----------------------------------------------------- | ---------------------------------------------- |
+| **Environment**    | Your local desktop browser                            | Isolated, sandboxed cloud instance             |
+| **Authentication** | Uses your existing logins and sessions                | Requires logging in within the session         |
+| **IP Address**     | Your trusted local IP                                 | Cloud server IP                                |
+| **Best For**       | Authenticated sites, premium tools, personal accounts | General research, broad web tasks, public data |
+
+The cloud browser remains essential for general tasks — it provides isolation, consistency, and works across any device without installation. But for workflows that require access to your authenticated sessions, the local browser holds a structural advantage.
+
+## Key Capabilities
+
+### True Autonomous Delegation
+
+Give Yantra a multi-step goal and it will plan, navigate, click, type, and execute the entire workflow across websites — without continuous supervision. You stay in control and can intervene at any time.
+
+### Powered by Your Active Sessions
+
+The extension works directly within your current browser session, securely utilizing your existing logins and active tabs to complete tasks on sites you already use and trust.
+
+### Automate Your Most Tedious Tasks
+
+Eliminate manual clicking, form filling, and cross-platform data extraction. From complex research and booking logistics to summarizing data, Yantra handles processes that take hours out of your day.
+
+## What You Can Do
+
+-   **Manage emails** — Draft, organize, and respond to emails across Gmail, Outlook, or any webmail
+-   **Shop for groceries** — Browse, compare prices, and add items to your cart on any grocery site
+-   **Fill forms** — Complete applications, registrations, and multi-step forms automatically
+-   **Research** — Cross-reference data across multiple premium sources and compile reports
+-   **Book travel** — Search flights, hotels, and coordinate logistics across booking platforms
+-   **Manage CRM** — Update records, log activities, and extract insights from Salesforce, HubSpot, etc.
+-   **Extract data** — Pull structured information from web pages and compile into spreadsheets
+
+## Availability
+
+The Yantra Browser extension is available for **Chrome** and **Chromium-based browsers** (Edge, Brave, Arc). Install it from the [Chrome Web Store](https://chromewebstore.google.com) to get started.
+
+For setup instructions, see [Getting Started with the Browser Extension](/help-center/browser-extension/getting-started-extension).
+
+For security details, see [Extension Security and Privacy](/help-center/browser-extension/extension-security).

package/lib/templates/content/browser-extension/extension-security.md

@@ -0,0 +1,126 @@
+---
+title: 'Extension Security and Privacy'
+description: 'How the Yantra Browser extension protects your data, what permissions it requires, and security best practices'
+author: 'Yantra Team'
+---
+
+# Extension Security and Privacy
+
+The Yantra Browser extension is built with security and transparency at its core. This article explains what data the extension accesses, how it's protected, and what controls you have.
+
+## Security Architecture
+
+### Encrypted Communications
+
+All communication between the extension and Yantra's backend services uses:
+
+-   **WSS (WebSocket Secure)** for the real-time relay connection
+-   **HTTPS** for all API requests
+-   **HMAC-SHA256** derived tokens for session authentication
+
+No data is ever transmitted in plaintext.
+
+### No Persistent Storage of Page Content
+
+Page content, screenshots, DOM snapshots, and accessibility data captured during automation are:
+
+-   Processed in real-time by the AI backend
+-   Used only to execute the current task
+-   **Not permanently stored** on our servers after the task completes
+
+### Local-Only Configuration
+
+Your extension settings (server URLs, preferences) are stored exclusively in Chrome's local storage, isolated per-extension by Chrome's security model. These never leave your browser.
+
+## Extension Permissions Explained
+
+The extension requests only the permissions necessary for browser automation. Here's what each one does and why it's needed:
+
+| Permission        | Why It's Needed                                                                                                 |
+| ----------------- | --------------------------------------------------------------------------------------------------------------- |
+| **debugger**      | Attach to tabs and send Chrome DevTools Protocol commands for page interaction, screenshots, and DOM inspection |
+| **tabs**          | Query, create, activate, and close tabs as part of automation workflows                                         |
+| **activeTab**     | Allow the popup to identify and toggle automation for the currently active tab                                  |
+| **storage**       | Save your configuration and maintain relay state across browser sessions                                        |
+| **alarms**        | Run a periodic health check (every 30 seconds) to keep relay connections alive                                  |
+| **webNavigation** | Detect when a tab finishes navigating so automation state can be restored                                       |
+| **cookies**       | Read authentication cookies from Yantra web app domains to reuse your existing session                          |
+| **scripting**     | Execute small configuration-reading scripts in Yantra web app tabs (never on third-party sites)                 |
+
+### Host Permissions
+
+The extension only has host permissions for Yantra's own domains:
+
+-   `*.yantra.app` — Yantra web application
+-   `*.cdebase.dev` — Development/staging environment
+-   `*.cdebase.io` — Backend services
+-   `dev-cdebase.auth0.com` — Authentication provider
+
+The extension **does not** have blanket access to all websites. It can only read cookies and execute scripts on these first-party domains.
+
+## What the Extension Can and Cannot See
+
+### When the relay is OFF (default state)
+
+The extension is completely inert. It:
+
+-   Cannot see any tab content
+-   Cannot read any page data
+-   Does not transmit any information
+-   Has no access to your browsing activity
+
+### When the relay is ON for a specific tab
+
+The extension can see and interact with **only the attached tab**:
+
+-   Page DOM structure and content
+-   Accessibility tree (semantic page layout)
+-   JavaScript execution context
+-   Page screenshots
+-   Navigation events
+
+It **cannot** see content in other tabs, your browsing history, or any data from non-attached pages.
+
+## User Control
+
+You have complete control over the extension at all times:
+
+| Action                         | How                                                                        |
+| ------------------------------ | -------------------------------------------------------------------------- |
+| **Stop automation on one tab** | Click the extension icon and toggle the relay OFF, or simply close the tab |
+| **Stop all automation**        | Click "Disconnect" in the extension popup                                  |
+| **Review what's happening**    | Watch the tab in real-time — all actions are visible                       |
+| **Remove the extension**       | Uninstall from chrome://extensions — all local data is deleted             |
+| **Reset settings**             | Use "Reset to Defaults" on the options page                                |
+
+## No Remote Code Execution
+
+The extension does **not**:
+
+-   Load or execute remote JavaScript files
+-   Use `eval()` or `Function()` constructors
+-   Inject external `<script>` tags
+-   Download and run WebAssembly from external sources
+
+All extension code is bundled at build time. The only dynamic execution is through Chrome's native `chrome.debugger.sendCommand` API, which is a sanctioned Chrome API for developer tooling.
+
+## Data We Never Collect
+
+-   Browsing history of non-automated tabs
+-   Keystrokes on non-automated pages
+-   Files from your local device
+-   Location data (GPS or IP-based)
+-   Microphone or camera data
+-   Financial information
+
+## Best Practices
+
+1. **Only attach tabs you want automated** — The extension only affects tabs with the relay toggled ON
+2. **Disconnect when not in use** — Click "Disconnect" in the popup when you're done with a task
+3. **Review before authorizing** — Check what site the tab is on before enabling automation
+4. **Keep the extension updated** — Updates include security patches and improvements
+5. **Use on trusted networks** — While all connections are encrypted, avoid public Wi-Fi for sensitive tasks
+
+For our full privacy policy, see [Privacy Policy](/privacy).
+
+For troubleshooting, see [Troubleshooting the Browser Extension](/help-center/browser-extension/troubleshooting-extension).

package/lib/templates/content/browser-extension/getting-started-extension.md

@@ -0,0 +1,96 @@
+---
+title: 'Getting Started with the Browser Extension'
+description: 'Step-by-step guide to installing, connecting, and using the Yantra Browser extension'
+author: 'Yantra Team'
+---
+
+# Getting Started with the Browser Extension
+
+Setting up the Yantra Browser extension takes just a few minutes. This guide walks you through installation, connecting to your Yantra account, and running your first automated task.
+
+## Prerequisites
+
+Before you begin, make sure you have:
+
+-   A **Yantra account** — sign up at [yantra.app](https://yantra.app) if you don't have one
+-   **Google Chrome**, Microsoft Edge, Brave, or another Chromium-based browser
+-   An active internet connection
+
+## Step 1: Install the Extension
+
+1. Visit the [Chrome Web Store listing](https://chromewebstore.google.com) for Yantra Browser
+2. Click **"Add to Chrome"**
+3. Confirm the installation when prompted
+4. The Yantra icon will appear in your browser toolbar
+
+> **Tip:** Pin the extension to your toolbar for easy access. Click the puzzle-piece icon in Chrome and pin Yantra Browser.
+
+## Step 2: Connect Your Account
+
+The extension needs to link to your Yantra account. There are two ways to connect:
+
+### Auto-Detect from Web App (Recommended)
+
+1. Open a tab and sign in to the Yantra web app at [yantra.app](https://yantra.app)
+2. Click the Yantra Browser extension icon in your toolbar
+3. The extension will automatically detect your active session
+4. You should see your name and avatar in the popup — you're connected
+
+### Manual Configuration
+
+If auto-detect doesn't work (for example, if you use a custom deployment):
+
+1. Click the Yantra Browser extension icon
+2. Click **"Settings"** at the bottom of the popup
+3. On the options page, expand **"Manual Sign In"** or **"Direct Connect"**
+4. Enter your relay host and authentication details
+5. Click **"Save"**
+
+## Step 3: Start Your First Task
+
+1. Navigate to any website where you want Yantra to work
+2. Click the Yantra Browser extension icon
+3. Toggle the **relay switch** to **ON** — this attaches Yantra to your current tab
+4. Go to the Yantra web app or chat interface
+5. Tell Yantra what you want to do, for example:
+    - _"Search for flights from NYC to London for next weekend on Google Flights"_
+    - _"Fill out this job application form with my saved details"_
+    - _"Extract all product prices from this comparison table"_
+6. Yantra will take control of the tab and execute the task
+
+## Understanding the Extension Popup
+
+The extension popup shows:
+
+-   **Connection status** — Whether you're connected to the Yantra backend
+-   **User info** — Your name and email from the connected account
+-   **Relay toggle** — Turn automation on/off for the current tab
+-   **Attached tabs** — List of tabs currently being automated
+-   **Status indicators** — Green (connected), yellow (connecting), red (disconnected)
+
+## Attaching Multiple Tabs
+
+You can attach Yantra to multiple tabs at once:
+
+1. Navigate to a tab you want to automate
+2. Click the extension icon and toggle the relay **ON**
+3. Repeat for additional tabs
+4. Yantra can switch between attached tabs as needed during a task
+
+## Detaching and Disconnecting
+
+-   **Detach a single tab:** Click the extension icon while on the tab and toggle the relay **OFF**
+-   **Disconnect entirely:** Click **"Disconnect"** in the extension popup to end the session
+
+When disconnected, no data is transmitted and the extension is inert.
+
+## Troubleshooting First Setup
+
+| Issue                                 | Solution                                                                                     |
+| ------------------------------------- | -------------------------------------------------------------------------------------------- |
+| Extension doesn't detect your session | Make sure you're signed into yantra.app in the same browser. Try refreshing the web app tab. |
+| Popup shows "Not Connected"           | Check your internet connection. Try clicking Settings → Auto-detect to retry.                |
+| Relay toggle doesn't stay on          | The tab may have navigated. Re-attach after the page finishes loading.                       |
+| Badge shows red                       | The relay connection was lost. Click the icon and reconnect.                                 |
+
+For more help, see [Troubleshooting the Browser Extension](/help-center/browser-extension/troubleshooting-extension).

package/lib/templates/content/browser-extension/how-it-works.md

@@ -0,0 +1,112 @@
+---
+title: 'How the Browser Extension Works'
+description: 'Technical overview of the Yantra Browser extension architecture, relay protocol, and automation model'
+author: 'Yantra Team'
+---
+
+# How the Browser Extension Works
+
+This article explains the architecture behind the Yantra Browser extension — how it connects your browser to the Yantra AI assistant and how automation commands are executed.
+
+## Architecture Overview
+
+The Yantra Browser extension uses a relay architecture with three primary components:
+
+```
+┌──────────────┐      WebSocket       ┌──────────────┐      API        ┌──────────────┐
+│   Chrome      │◄────────────────────►│   Relay       │◄──────────────►│   Yantra AI   │
+│   Extension   │   Secure (WSS)      │   Gateway     │   HTTPS       │   Backend     │
+└──────┬───────┘                      └──────────────┘                └──────────────┘
+       │
+       │ Chrome DevTools
+       │ Protocol (CDP)
+       ▼
+┌──────────────┐
+│   Browser     │
+│   Tab         │
+└──────────────┘
+```
+
+1. **Chrome Extension** — A Manifest V3 service worker that attaches to browser tabs and sends/receives CDP commands
+2. **Relay Gateway** — A secure WebSocket server that routes automation commands between the AI backend and the extension
+3. **Yantra AI Backend** — The intelligent agent that plans and executes multi-step workflows
+
+## The Relay Protocol
+
+When you activate the extension on a tab, the following happens:
+
+### Connection Phase
+
+1. The extension authenticates with the Yantra backend using your existing web app session
+2. A secure WebSocket connection is established to the relay gateway
+3. The extension receives a workspace assignment and session token
+4. The extension attaches Chrome's debugger to the target tab using Chrome DevTools Protocol (CDP)
+
+### Automation Phase
+
+1. The AI backend sends a high-level task instruction
+2. The relay gateway forwards specific CDP commands to the extension
+3. The extension executes commands on the attached tab:
+    - **Page navigation** — Navigate to URLs, wait for page load
+    - **DOM inspection** — Read page structure, find elements
+    - **Accessibility tree** — Understand page layout semantically
+    - **JavaScript execution** — Click buttons, fill forms, extract data
+    - **Screenshots** — Capture visual state for the AI to analyze
+4. Results flow back through the relay to the AI backend
+5. The AI plans the next step and the cycle continues
+
+### Keepalive and Recovery
+
+The extension runs a health check every 30 seconds to:
+
+-   Verify the CDP connection to attached tabs is still active
+-   Check that the WebSocket relay connection is healthy
+-   Automatically re-attach and reconnect if anything drops
+-   Handle tab navigation (re-enable CDP domains on new pages)
+
+## Chrome DevTools Protocol (CDP)
+
+The extension uses CDP — the same protocol that powers Chrome DevTools — to interact with web pages. This is a browser-native API, not a hack or injection.
+
+CDP domains used:
+
+| Domain            | Purpose                                   |
+| ----------------- | ----------------------------------------- |
+| **Page**          | Navigation, screenshots, frame management |
+| **Runtime**       | JavaScript execution, value evaluation    |
+| **DOM**           | Document structure, element queries       |
+| **Accessibility** | Semantic page understanding (AX tree)     |
+| **Target**        | Tab and window management                 |
+
+## What Happens on Your Tab
+
+When automation is active on a tab:
+
+1. Chrome shows a **"Yantra Browser started debugging this tab"** banner — this is Chrome's built-in security indicator when CDP is attached
+2. The tab behaves normally — you can scroll, click, and interact
+3. If Yantra sends a command, it executes in the tab's context (like clicking a button or typing in a field)
+4. You can take over at any time by simply clicking in the tab
+5. Closing the tab immediately stops all automation on it
+
+## Service Worker Lifecycle
+
+The extension uses a Manifest V3 service worker, which Chrome may suspend when idle. The extension handles this by:
+
+-   Persisting relay state in `chrome.storage.session` so it survives restarts
+-   Using `chrome.alarms` to prevent suspension during active sessions
+-   Automatically restoring connections when the service worker wakes up
+
+This means automation continues reliably even if Chrome temporarily suspends the background process.
+
+## Data Flow Summary
+
+| Data                 | Direction           | Purpose                      |
+| -------------------- | ------------------- | ---------------------------- |
+| CDP commands         | Backend → Extension | Tell the browser what to do  |
+| DOM/AX snapshots     | Extension → Backend | Let the AI "see" the page    |
+| Screenshots          | Extension → Backend | Visual understanding         |
+| JS execution results | Extension → Backend | Extract data, verify actions |
+| Navigation events    | Extension → Backend | Track page changes           |
+| Auth tokens          | Extension → Backend | Authenticate the session     |
+
+All data flows through encrypted channels (WSS/HTTPS). See [Extension Security and Privacy](/help-center/browser-extension/extension-security) for details.