@hanzo/browser-extension 1.7.2

package/.github/workflows/docs.yml

@@ -0,0 +1,44 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Build with Jekyll
+        uses: actions/jekyll-build-pages@v1
+        with:
+          source: ./docs
+          destination: ./_site
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/.github/workflows/release.yml

@@ -0,0 +1,55 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci || npm install
+
+      - name: Build extension
+        run: npm run build
+
+      - name: Get version
+        id: version
+        run: echo "version=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
+
+      - name: Package Chrome extension
+        run: |
+          cd dist
+          zip -r ../hanzo-browser-extension-chrome-${{ steps.version.outputs.version }}.zip .
+
+      - name: Package Firefox extension
+        run: |
+          # Copy Firefox manifest if exists
+          if [ -f src/manifest-firefox.json ]; then
+            cp src/manifest-firefox.json dist/manifest.json
+          fi
+          cd dist
+          zip -r ../hanzo-browser-extension-firefox-${{ steps.version.outputs.version }}.zip .
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            hanzo-browser-extension-chrome-*.zip
+            hanzo-browser-extension-firefox-*.zip
+          generate_release_notes: true
+          draft: false
+          prerelease: ${{ contains(github.ref, 'alpha') || contains(github.ref, 'beta') || contains(github.ref, 'rc') }}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Hanzo AI Inc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,126 @@
+# Hanzo AI Browser Extension
+
+AI-powered browser extension for Chrome, Firefox, Edge, and Safari.
+
+[![Chrome](https://img.shields.io/badge/Chrome-4285F4?style=for-the-badge&logo=googlechrome&logoColor=white)](https://chrome.google.com/webstore)
+[![Firefox](https://img.shields.io/badge/Firefox-FF7139?style=for-the-badge&logo=firefox&logoColor=white)](https://addons.mozilla.org)
+[![Edge](https://img.shields.io/badge/Edge-0078D7?style=for-the-badge&logo=microsoftedge&logoColor=white)](https://microsoftedge.microsoft.com/addons)
+[![Safari](https://img.shields.io/badge/Safari-000000?style=for-the-badge&logo=safari&logoColor=white)](https://apps.apple.com)
+
+## Features
+
+- **AI Chat Sidebar**: Chat with Claude, GPT-4, Gemini, and more
+- **Page Analysis**: Summarize, explain, and query any webpage
+- **Selection Actions**: Right-click menu for AI operations on selected text
+- **MCP Integration**: Access 260+ MCP tools from your browser
+- **Cloud Sync**: Sync conversations and settings via cloud.hanzo.ai
+
+## Installation
+
+### Chrome / Edge / Brave
+
+1. Download the latest release from [Releases](https://github.com/hanzoai/browser-extension/releases)
+2. Open `chrome://extensions` (or `edge://extensions`)
+3. Enable "Developer mode"
+4. Click "Load unpacked" and select the `dist` folder
+
+### Firefox
+
+1. Download the latest release
+2. Open `about:debugging`
+3. Click "This Firefox" → "Load Temporary Add-on"
+4. Select `manifest.json`
+
+### Safari
+
+1. Enable developer mode in Safari preferences
+2. Download the macOS app version from [Releases](https://github.com/hanzoai/browser-extension/releases)
+3. Open the app and enable the extension in Safari preferences
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build extension
+npm run build
+
+# Watch mode for development
+npm run watch
+
+# Run tests
+npm test
+```
+
+## Building for Production
+
+```bash
+# Build for all browsers
+npm run build
+
+# The dist/ folder contains the extension ready for loading
+```
+
+## Project Structure
+
+```
+browser-extension/
+├── src/
+│   ├── background/    # Service worker / background script
+│   ├── content/       # Content scripts injected into pages
+│   ├── popup/         # Extension popup UI
+│   ├── sidebar/       # AI chat sidebar
+│   └── shared/        # Shared utilities
+├── dist/              # Built extension
+├── manifest.json      # Extension manifest (MV3)
+├── package.json
+└── tsconfig.json
+```
+
+## Configuration
+
+### API Keys
+
+The extension uses your Hanzo AI account for API access. Login at:
+- [cloud.hanzo.ai](https://cloud.hanzo.ai) - Cloud dashboard
+- [iam.hanzo.ai](https://iam.hanzo.ai) - API key management
+
+Or set environment variables for direct provider access:
+- `ANTHROPIC_API_KEY` - Claude models
+- `OPENAI_API_KEY` - GPT models
+- `GOOGLE_API_KEY` - Gemini models
+
+### Permissions
+
+The extension requests minimal permissions:
+- `activeTab` - Access to current tab when activated
+- `storage` - Store settings and conversations locally
+- `contextMenus` - Right-click menu integration
+
+## Architecture
+
+```
+┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
+│ Content Script  │ ◄──► │ Background       │ ◄──► │ Hanzo API       │
+│ (Page Context)  │     │ (Service Worker) │     │ (api.hanzo.ai)  │
+└─────────────────┘     └──────────────────┘     └─────────────────┘
+         │                      │
+         │                      │
+         ▼                      ▼
+┌─────────────────┐     ┌──────────────────┐
+│ Popup / Sidebar │     │ MCP Bridge       │
+│ (React UI)      │     │ (WebSocket)      │
+└─────────────────┘     └──────────────────┘
+```
+
+## Related Projects
+
+- [ide-extension](https://github.com/hanzoai/ide-extension) - VS Code and JetBrains plugins
+- [hanzo-mcp](https://github.com/hanzoai/mcp) - Model Context Protocol tools
+- [hanzo.vim](https://github.com/hanzoai/hanzo.vim) - Vim/Neovim plugin
+- [hanzo.el](https://github.com/hanzoai/hanzo.el) - Emacs package
+
+## License
+
+MIT - See [LICENSE](LICENSE)

package/dist/browser-extension/README.md

@@ -0,0 +1,43 @@
+# Hanzo Browser DevTools
+
+Click-to-code navigation for web developers with MCP integration.
+
+## Installation
+
+```bash
+npm install -g @hanzoai/browser-devtools
+```
+
+## Usage
+
+1. Start the server:
+```bash
+hanzo-browser-server start
+```
+
+2. Install the browser extension:
+```bash
+hanzo-browser-server install-extension
+```
+
+3. Alt+Click any element in your browser to navigate to its source code!
+
+## Features
+
+- 🎯 **Source-map support** for React, Vue, Svelte
+- 🔍 **Fallback tagging** for legacy code
+- 🚀 **MCP integration** for Claude Code
+- ⚡ **Lightning fast** WebSocket communication
+
+## Integration with Claude Code
+
+The server exposes element selection events that can be consumed by MCP tools:
+
+```javascript
+server.on('elementSelected', (data) => {
+  // data.file - Source file path
+  // data.line - Line number
+  // data.column - Column number (if available)
+  // data.framework - Detected framework
+});
+```

package/dist/browser-extension/ai-worker.js

@@ -0,0 +1,30 @@
+// AI Worker stub for browser extension
+// This is a Web Worker that handles AI inference tasks per-tab
+
+self.onmessage = function(event) {
+  const { type, tabId, modelName } = event.data;
+
+  switch (type) {
+    case 'init':
+      console.log(`[AI Worker] Initialized for tab ${tabId} with model ${modelName}`);
+      self.postMessage({ type: 'ready', tabId });
+      break;
+
+    case 'screenshot':
+      // Process screenshot for AI analysis (stub)
+      self.postMessage({ type: 'analysis', result: 'Screenshot received' });
+      break;
+
+    case 'contentMessage':
+      // Handle content script messages (stub)
+      self.postMessage({ type: 'contentResponse', response: { received: true } });
+      break;
+
+    case 'broadcast':
+      // Handle broadcast messages (stub)
+      break;
+
+    default:
+      console.warn('[AI Worker] Unknown message type:', type);
+  }
+};