prep extension

Author: Sentience Dev

sentience/extension/README.md

@@ -0,0 +1,51 @@
+# Sentience Chrome Extension (Embedded)
+
+This directory contains the Sentience Chrome extension files bundled with the Python SDK.
+
+## Auto-Sync
+
+These files are automatically synced from the [sentience-chrome](https://github.com/rcholic/Sentience-Geometry-Chrome-Extension) repository when new releases are published.
+
+## Files
+
+- `manifest.json` - Chrome extension manifest
+- `content.js` - Content script injected into web pages
+- `background.js` - Background service worker
+- `injected_api.js` - API injected into page context
+- `pkg/` - WebAssembly bindings and core logic
+  - `sentience_core.js` - WASM JavaScript bindings
+  - `sentience_core_bg.wasm` - Compiled WebAssembly binary
+  - `*.d.ts` - TypeScript definitions
+
+## Usage
+
+The extension is automatically loaded by `SentienceBrowser` when you create a browser instance:
+
+```python
+from sentience import SentienceBrowser
+
+with SentienceBrowser() as browser:
+    browser.page.goto("https://example.com")
+    # Extension is automatically loaded and active
+```
+
+## Development
+
+For local development, you can use the development extension at `../sentience-chrome/` instead. The SDK will automatically detect and use it if available.
+
+## Manual Update
+
+If you need to manually update the extension files:
+
+```bash
+# Copy from sentience-chrome repo
+cp ../sentience-chrome/manifest.json sentience/extension/
+cp ../sentience-chrome/*.js sentience/extension/
+cp -r ../sentience-chrome/pkg sentience/extension/
+```
+
+Or trigger the sync workflow manually:
+
+```bash
+gh workflow run sync-extension.yml -f release_tag=v1.0.0
+```

sentience/extension/background.js

@@ -0,0 +1,63 @@
+// background.js - Service Worker for screenshot capture
+// Chrome extensions can only capture screenshots from the background script
+// Listen for screenshot requests from content script
+chrome.runtime.onMessage.addListener((request, sender, sendResponse) => {
+  if (request.action === 'captureScreenshot') {
+    handleScreenshotCapture(sender.tab.id, request.options)
+      .then(screenshot => {
+        sendResponse({ success: true, screenshot });
+      })
+      .catch(error => {
+        console.error('[Sentience] Screenshot capture failed:', error);
+        sendResponse({
+          success: false,
+          error: error.message || 'Screenshot capture failed'
+        });
+      });
+
+    // Return true to indicate we'll send response asynchronously
+    return true;
+  }
+});
+
+/**
+ * Capture screenshot of the active tab
+ * @param {number} tabId - Tab ID to capture
+ * @param {Object} options - Screenshot options
+ * @returns {Promise<string>} Base64-encoded PNG data URL
+ */
+async function handleScreenshotCapture(tabId, options = {}) {
+  try {
+    const {
+      format = 'png',      // 'png' or 'jpeg'
+      quality = 90         // JPEG quality (0-100), ignored for PNG
+    } = options;
+
+    // Capture visible tab as data URL
+    const dataUrl = await chrome.tabs.captureVisibleTab(null, {
+      format: format,
+      quality: quality
+    });
+
+    console.log(`[Sentience] Screenshot captured: ${format}, size: ${dataUrl.length} bytes`);
+
+    return dataUrl;
+  } catch (error) {
+    console.error('[Sentience] Screenshot error:', error);
+    throw new Error(`Failed to capture screenshot: ${error.message}`);
+  }
+}
+
+/**
+ * Optional: Add viewport-specific capture (requires additional setup)
+ * This would allow capturing specific regions, not just visible area
+ */
+async function captureRegion(tabId, region) {
+  // For region capture, you'd need to:
+  // 1. Capture full visible tab
+  // 2. Use Canvas API to crop to region
+  // 3. Return cropped image
+
+  // Not implemented in this basic version
+  throw new Error('Region capture not yet implemented');
+}

sentience/extension/content.js

@@ -0,0 +1,22 @@
+// content.js - ISOLATED WORLD
+console.log('[Sentience] Bridge loaded.');
+
+// 1. Pass Extension ID to Main World (So WASM knows where to load from)
+document.documentElement.dataset.sentienceExtensionId = chrome.runtime.id;
+
+// 2. Proxy for Screenshots (The only thing Isolated World needs to do)
+window.addEventListener('message', (event) => {
+    // Security check: only accept messages from same window
+    if (event.source !== window || event.data.type !== 'SENTIENCE_SCREENSHOT_REQUEST') return;
+
+    chrome.runtime.sendMessage(
+        { action: 'captureScreenshot', options: event.data.options },
+        (response) => {
+            window.postMessage({
+                type: 'SENTIENCE_SCREENSHOT_RESULT',
+                requestId: event.data.requestId,
+                screenshot: response?.success ? response.screenshot : null
+            }, '*');
+        }
+    );
+});