gentyr 1.3.0

package/packages/mcp-servers/dist/chrome-bridge/browser-tips.js

@@ -0,0 +1,167 @@
+/**
+ * Browser Automation Tips — Contextual tips injected into chrome-bridge
+ * tool responses based on the site the agent is interacting with.
+ *
+ * Tips are sourced from docs/SETUP-GUIDE.md and shown at most once per
+ * MCP server session (lifetime = Claude Code session).
+ */
+// ============================================================================
+// Tip Data (verbatim from docs/SETUP-GUIDE.md)
+// ============================================================================
+/** Interactive tools that trigger tip evaluation */
+const INTERACTIVE_TOOLS = ['navigate', 'computer', 'form_input', 'find', 'read_page'];
+const ALL_INTERACTIVE = [...INTERACTIVE_TOOLS];
+export const BROWSER_TIPS = [
+    // --- General tips (any site) ---
+    {
+        id: 'general-form-input',
+        hostnames: [],
+        tools: ALL_INTERACTIVE,
+        text: 'Prefer `form_input` over `click` + `type` for filling form fields — it\'s more reliable and handles special characters (e.g., `/`, `@`) that `type` may misinterpret as keyboard shortcuts.',
+    },
+    {
+        id: 'general-read-page-interactive',
+        hostnames: [],
+        tools: ALL_INTERACTIVE,
+        text: 'Use `read_page(filter="interactive")` to discover form elements and buttons before interacting with them.',
+    },
+    {
+        id: 'general-zoom-verify',
+        hostnames: [],
+        tools: ALL_INTERACTIVE,
+        text: 'Use the `computer` tool\'s `zoom` action to verify small UI elements (checkboxes, toggles, dropdown states) before and after interaction.',
+    },
+    {
+        id: 'general-get-page-text',
+        hostnames: [],
+        tools: ALL_INTERACTIVE,
+        text: 'Use `get_page_text` to extract values from the page (API keys, tokens, IDs) rather than trying to select/copy text via UI interactions.',
+    },
+    {
+        id: 'general-extension-recovery',
+        hostnames: [],
+        tools: ALL_INTERACTIVE,
+        text: 'Chrome Extension interference: Browser extensions (especially 1Password) can inject errors like `Cannot access a chrome-extension:// URL` across unrelated sites. Recovery: call `navigate()` to the current URL to refresh the page, then retry.',
+    },
+    // --- Site-specific tips ---
+    {
+        id: '1password-fields',
+        hostnames: ['1password.com'],
+        tools: ALL_INTERACTIVE,
+        text: 'When adding fields to a 1Password item, the `+ add another field` button and its dropdown chevron (`▼`) are **separate clickable controls**. Click the chevron first to select the field type (e.g., "password"), then click the `+` button to create the field. After creating the field, use `form_input` to set both the label and value. Built-in template fields may not match the required field name — always add a **new custom field** with the exact name specified.',
+    },
+    {
+        id: 'github-form-input',
+        hostnames: ['github.com'],
+        tools: ALL_INTERACTIVE,
+        text: 'Use `form_input` (not `type`) for the token name field, especially if the name contains `/` or other special characters that browsers interpret as shortcuts.',
+    },
+    {
+        id: 'render-api-key-capture',
+        hostnames: ['dashboard.render.com'],
+        tools: ALL_INTERACTIVE,
+        text: 'The Render API key is displayed once after creation. Use `get_page_text` immediately to capture it before navigating away.',
+    },
+    {
+        id: 'vercel-token-capture',
+        hostnames: ['vercel.com'],
+        tools: ALL_INTERACTIVE,
+        text: 'The Vercel token is displayed once after creation. Use `get_page_text` to capture it. The Team ID on the Settings page can also be extracted via `get_page_text` — look for the string labeled "Team ID".',
+    },
+    {
+        id: 'cloudflare-zone-id',
+        hostnames: ['dash.cloudflare.com'],
+        tools: ALL_INTERACTIVE,
+        text: 'The Cloudflare Zone ID is visible on the domain overview page without clicking into any sub-menus. Use `get_page_text` to extract it — look for a 32-character hex string near "Zone ID" in the right sidebar. The token creation flow uses a multi-step wizard with dropdowns; use `read_page(filter="interactive")` to find selectors at each step.',
+    },
+    {
+        id: 'supabase-keys',
+        hostnames: ['supabase.com'],
+        tools: ALL_INTERACTIVE,
+        text: 'The Supabase API page shows the `anon` key, `service_role` key, and URL all on one page. Use `get_page_text` to extract all three at once. The `service_role` key is hidden behind a "Reveal" button — click it first, then extract. For the management access token, it is displayed once after generation — capture immediately with `get_page_text`.',
+    },
+    {
+        id: 'elastic-dev-tools',
+        hostnames: ['cloud.elastic.co'],
+        tools: ALL_INTERACTIVE,
+        text: 'The Elastic Cloud "Create API Key" UI has unreliable toggles and role selectors with browser automation. **Strongly prefer using the Dev Tools Console** (REST API) instead: navigate to Dev Tools, run `POST /_security/api_key` with the desired role descriptors, then use `get_page_text` to extract the JSON response. Store the `encoded` value — it is the base64-encoded `id:api_key` string ready for use.',
+    },
+    {
+        id: 'resend-api-key-capture',
+        hostnames: ['resend.com'],
+        tools: ALL_INTERACTIVE,
+        text: 'The Resend API key is displayed once after creation. Use `get_page_text` to capture it immediately. Select the permission dropdown ("Full access" vs "Sending access") before clicking "Create".',
+    },
+    {
+        id: 'codecov-oauth-workaround',
+        hostnames: ['app.codecov.io', 'codecov.io'],
+        tools: ALL_INTERACTIVE,
+        text: 'Codecov uses GitHub OAuth for login, which can be disrupted by Chrome extensions. If the OAuth redirect fails or loops, ask the user to log in manually first, then navigate directly to the repository settings page. The Upload Token is visible on the settings page without any reveal/toggle — use `get_page_text` to extract it.',
+    },
+];
+// ============================================================================
+// Tracker
+// ============================================================================
+export class BrowserTipTracker {
+    shownTips = new Set();
+    /**
+     * Returns formatted tip text for the given tool call and tab URL,
+     * or null if no tips are relevant or all relevant tips have been shown.
+     */
+    getRelevantTips(toolName, tabUrl) {
+        // Only interactive tools trigger tip evaluation
+        if (!INTERACTIVE_TOOLS.includes(toolName)) {
+            return null;
+        }
+        // Parse hostname from URL
+        let hostname;
+        if (tabUrl) {
+            try {
+                hostname = new URL(tabUrl).hostname;
+            }
+            catch {
+                // Malformed URL — skip site-specific tips
+            }
+        }
+        // Collect unseen tips that match this context
+        const matchingTips = [];
+        for (const tip of BROWSER_TIPS) {
+            // Skip already-shown tips
+            if (this.shownTips.has(tip.id))
+                continue;
+            // Check tool match
+            if (!tip.tools.includes(toolName))
+                continue;
+            // Check hostname match
+            if (tip.hostnames.length > 0) {
+                // Site-specific: hostname must match
+                if (!hostname)
+                    continue;
+                const matches = tip.hostnames.some((h) => hostname === h || hostname.endsWith('.' + h));
+                if (!matches)
+                    continue;
+            }
+            matchingTips.push(tip);
+        }
+        if (matchingTips.length === 0)
+            return null;
+        // Mark all as shown
+        for (const tip of matchingTips) {
+            this.shownTips.add(tip.id);
+        }
+        // Determine site label
+        const siteSpecific = matchingTips.filter((t) => t.hostnames.length > 0);
+        const general = matchingTips.filter((t) => t.hostnames.length === 0);
+        const sections = [];
+        if (general.length > 0) {
+            sections.push('---', 'Browser Automation Tips (General):', ...general.map((t) => `- ${t.text}`));
+        }
+        if (siteSpecific.length > 0) {
+            const siteLabel = hostname ?? 'Site';
+            sections.push(general.length > 0 ? '' : '---', `Browser Automation Tips (${siteLabel}):`, ...siteSpecific.map((t) => `- ${t.text}`));
+        }
+        sections.push('---');
+        return sections.join('\n');
+    }
+}
+//# sourceMappingURL=browser-tips.js.map

package/packages/mcp-servers/dist/chrome-bridge/browser-tips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-tips.js","sourceRoot":"","sources":["../../src/chrome-bridge/browser-tips.ts"],"names":[],"mappings":"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"}

package/packages/mcp-servers/dist/chrome-bridge/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Chrome Bridge MCP Server -- Public exports
+ */
+export * from './types.js';
+export * from './browser-tips.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/mcp-servers/dist/chrome-bridge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chrome-bridge/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC"}

package/packages/mcp-servers/dist/chrome-bridge/index.js

@@ -0,0 +1,6 @@
+/**
+ * Chrome Bridge MCP Server -- Public exports
+ */
+export * from './types.js';
+export * from './browser-tips.js';
+//# sourceMappingURL=index.js.map

package/packages/mcp-servers/dist/chrome-bridge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chrome-bridge/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC"}

package/packages/mcp-servers/dist/chrome-bridge/server.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Chrome Bridge MCP Server
+ *
+ * Proxies MCP tool calls to the Claude Chrome Extension via its Unix domain
+ * socket at /tmp/claude-mcp-browser-bridge-{username}/*.sock.
+ *
+ * Protocol: Length-prefixed JSON (4-byte LE uint32 length + UTF-8 JSON payload)
+ * over Unix domain socket. The Chrome extension handles all browser automation;
+ * this server is a pure proxy.
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/packages/mcp-servers/dist/chrome-bridge/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/chrome-bridge/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}