web-agent-bridge 3.0.0 → 3.3.0

package/public/llms.txt

@@ -1,86 +1,125 @@
-# Web Agent Bridge (WAB)
-
-> Open protocol and runtime for AI agent ↔ website interaction.
-
-## What is WAB?
-
-Web Agent Bridge is an open standard that allows AI agents to interact with websites using structured commands instead of fragile DOM scraping. It provides a Discovery Protocol, Command Protocol, Lifecycle Protocol, and Fairness Engine — making the web machine-readable and agent-friendly.
-
-## Key Facts
-
-- **Type**: Open protocol + JavaScript runtime + Node.js server
-- **License**: MIT
-- **Version**: 1.2.0
-- **Protocol**: WAB Protocol v1.0
-- **Website**: https://webagentbridge.com
-- **npm**: https://www.npmjs.com/package/web-agent-bridge
-- **GitHub**: https://github.com/abokenan444/web-agent-bridge
-- **Security Audit**: https://socket.dev/npm/package/web-agent-bridge
-- **YouTube**: https://youtube.com/@abokenan4
-
-## Problem It Solves
-
-AI agents today interact with websites through brittle DOM scraping, CSS selectors that break, and screen parsing. WAB solves this by providing a standardized protocol that websites can implement to declare their capabilities, actions, and data — making agent interaction reliable, fast, and fair.
-
-## Core Components
-
-1. **Discovery Protocol** — Websites serve `agent-bridge.json` or `/.well-known/wab.json` to declare capabilities
-2. **Command Protocol** — Standardized JSON format for agent commands (click, fill, navigate, read, submit)
-3. **Lifecycle Protocol** — Five phases: Discover → Authenticate → Plan → Execute → Confirm
-4. **Fairness Engine** — Prevents AI bias toward large platforms; ensures small businesses get equal visibility
-5. **MCP Compatibility** — `wab-mcp-adapter` converts WAB commands into MCP tools for any LLM
-6. **NoScript Fallback** — HTTP-only agents can interact via REST API when JavaScript is unavailable
-7. **Private Agent Mesh** — Inter-agent communication, local reinforcement learning, and symphony orchestration without external LLM dependency
-
-## Use Cases
-
-- Make any website AI-agent-ready in minutes
-- Enable AI assistants (ChatGPT, Claude, Gemini) to interact with websites via structured commands
-- Build fair AI shopping/booking agents that don't favor large platforms
-- Create automation workflows without fragile selectors
-- WordPress plugin available for one-click integration
-
-## Quick Start
-
-```bash
-npm install web-agent-bridge
-npx web-agent-bridge start
-```
-
-Or add the script to any HTML page:
-
-```html
-<script src="https://webagentbridge.com/script/ai-agent-bridge.js"></script>
-```
-
-## How WAB Compares
-
-| Feature | WAB | Screen Scraping | Browser Automation |
-|---------|-----|-----------------|-------------------|
-| Reliability | ✅ Structured commands | ❌ Breaks with UI changes | ⚠️ Fragile selectors |
-| Speed | ✅ Direct API | ❌ Slow parsing | ⚠️ Browser overhead |
-| Permission model | ✅ Granular | ❌ None | ❌ None |
-| Fairness | ✅ Built-in engine | ❌ Biased to known sites | ❌ Biased to known sites |
-| MCP compatible | ✅ Native adapter | ❌ No | ❌ No |
-| Standards-based | ✅ Open protocol | ❌ Ad hoc | ❌ Proprietary |
-
-## Related Concepts
-
-- OpenAPI (for REST APIs) — WAB is "OpenAPI for websites"
-- Model Context Protocol (MCP) — WAB integrates with MCP via adapter
-- robots.txt — WAB's agent-bridge.json is the next evolution
-- Schema.org — WAB adds actionable commands on top of structured data
-
-## Who Should Use WAB
-
-- **Website owners** who want AI agents to interact with their site properly
-- **AI agent developers** who need reliable website interaction
-- **E-commerce platforms** that want fair AI-driven discovery
-- **WordPress sites** via the official plugin
-- **Any developer** building for the Agentic Web
-
-## Contact
-
-- Support: support@webagentbridge.com
-- Sales: sales@webagentbridge.com
-- GitHub Issues: https://github.com/abokenan444/web-agent-bridge/issues
+# Web Agent Bridge (WAB)
+
+> Open protocol and runtime for AI agent ↔ website interaction.
+
+## What is WAB?
+
+Web Agent Bridge is an open standard that allows AI agents to interact with websites using structured commands instead of fragile DOM scraping. It provides a Discovery Protocol, Command Protocol, Lifecycle Protocol, and Fairness Engine — making the web machine-readable and agent-friendly.
+
+## Key Facts
+
+- **Type**: Open protocol + JavaScript runtime + Node.js server
+- **License**: MIT
+- **Version**: 1.2.0
+- **Protocol**: WAB Protocol v1.0
+- **Website**: https://webagentbridge.com
+- **npm**: https://www.npmjs.com/package/web-agent-bridge
+- **GitHub**: https://github.com/abokenan444/web-agent-bridge
+- **Security Audit**: https://socket.dev/npm/package/web-agent-bridge
+- **YouTube**: https://youtube.com/@abokenan4
+
+## Problem It Solves
+
+AI agents today interact with websites through brittle DOM scraping, CSS selectors that break, and screen parsing. WAB solves this by providing a standardized protocol that websites can implement to declare their capabilities, actions, and data — making agent interaction reliable, fast, and fair.
+
+## Core Components
+
+1. **Discovery Protocol** — Websites serve `agent-bridge.json` or `/.well-known/wab.json` to declare capabilities
+2. **Command Protocol** — Standardized JSON format for agent commands (click, fill, navigate, read, submit)
+3. **Lifecycle Protocol** — Five phases: Discover → Authenticate → Plan → Execute → Confirm
+4. **Fairness Engine** — Prevents AI bias toward large platforms; ensures small businesses get equal visibility
+5. **MCP Compatibility** — `wab-mcp-adapter` converts WAB commands into MCP tools for any LLM
+6. **NoScript Fallback** — HTTP-only agents can interact via REST API when JavaScript is unavailable
+7. **Private Agent Mesh** — Inter-agent communication, local reinforcement learning, and symphony orchestration without external LLM dependency
+
+## Use Cases
+
+- Make any website AI-agent-ready in minutes
+- Enable AI assistants (ChatGPT, Claude, Gemini) to interact with websites via structured commands
+- Build fair AI shopping/booking agents that don't favor large platforms
+- Create automation workflows without fragile selectors
+- WordPress plugin available for one-click integration
+
+## Quick Start
+
+```bash
+npm install web-agent-bridge
+npx web-agent-bridge start
+```
+
+Or add the script to any HTML page:
+
+```html
+<script src="https://webagentbridge.com/script/ai-agent-bridge.js"></script>
+```
+
+## How WAB Compares
+
+| Feature | WAB | Screen Scraping | Browser Automation |
+|---------|-----|-----------------|-------------------|
+| Reliability | ✅ Structured commands | ❌ Breaks with UI changes | ⚠️ Fragile selectors |
+| Speed | ✅ Direct API | ❌ Slow parsing | ⚠️ Browser overhead |
+| Permission model | ✅ Granular | ❌ None | ❌ None |
+| Fairness | ✅ Built-in engine | ❌ Biased to known sites | ❌ Biased to known sites |
+| MCP compatible | ✅ Native adapter | ❌ No | ❌ No |
+| Standards-based | ✅ Open protocol | ❌ Ad hoc | ❌ Proprietary |
+
+## Related Concepts
+
+- OpenAPI (for REST APIs) — WAB is "OpenAPI for websites"
+- Model Context Protocol (MCP) — WAB integrates with MCP via adapter
+- robots.txt — WAB's agent-bridge.json is the next evolution
+- Schema.org — WAB adds actionable commands on top of structured data
+
+## Who Should Use WAB
+
+- **Website owners** who want AI agents to interact with their site properly
+- **AI agent developers** who need reliable website interaction
+- **E-commerce platforms** that want fair AI-driven discovery
+- **WordPress sites** via the official plugin
+- **Any developer** building for the Agentic Web
+
+## MCP Server (for AI Coding Tools)
+
+WAB provides a Model Context Protocol (MCP) server that works with Cursor, Claude Desktop, Cline, Windsurf, and other MCP-compatible AI tools.
+
+### Install
+```bash
+npm install -g wab-mcp-server
+# or use directly
+npx wab-mcp-server
+```
+
+### Configure (Cursor / Claude Desktop)
+Add to your MCP configuration:
+```json
+{
+  "mcpServers": {
+    "wab": {
+      "command": "npx",
+      "args": ["-y", "wab-mcp-server"]
+    }
+  }
+}
+```
+
+### Available MCP Tools
+- `wab_scan_url` — Scan URLs for phishing, malware, and scams (47 databases)
+- `wab_fairness_check` — Score platform transparency (0-100, 15 signals)
+- `wab_find_deals` — Cross-platform price intelligence with fairness filtering
+- `wab_agent_query` — Natural language web automation
+- `wab_generate_snippet` — Generate WAB integration code (JS, Python, React, Next.js, Docker)
+- `wab_get_docs` — Get WAB documentation and API reference
+
+## SDK Packages
+
+- **JavaScript/Node.js**: `npm install @wab/sdk`
+- **React**: `npm install @wab/react`
+- **Python**: `pip install wab-sdk`
+- **MCP Server**: `npm install -g wab-mcp-server`
+
+## Contact
+
+- Support: support@webagentbridge.com
+- Sales: sales@webagentbridge.com
+- GitHub Issues: https://github.com/abokenan444/web-agent-bridge/issues

package/public/login.html

@@ -1,83 +1,85 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Sign In — Web Agent Bridge</title>
-  <link rel="preconnect" href="https://fonts.googleapis.com">
-  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
-  <link rel="stylesheet" href="/css/styles.css">
-  <script src="/js/auth-redirect.js"></script>
-</head>
-<body>
-  <div class="auth-page">
-    <div class="auth-card fade-in">
-      <div style="text-align:center; margin-bottom:32px;">
-        <a href="/" class="navbar-brand" style="justify-content:center;">
-          <div class="brand-icon">⚡</div>
-          <span>WAB</span>
-        </a>
-      </div>
-      <h1 style="text-align:center;">Welcome back</h1>
-      <p class="subtitle" style="text-align:center;">Sign in to your account</p>
-
-      <div class="alert alert-error" id="errorAlert"></div>
-
-      <form id="loginForm">
-        <div class="form-group">
-          <label for="email">Email</label>
-          <input type="email" id="email" class="form-input" placeholder="you@example.com" required>
-        </div>
-        <div class="form-group">
-          <label for="password">Password</label>
-          <input type="password" id="password" class="form-input" placeholder="Your password" required>
-        </div>
-        <button type="submit" class="btn btn-primary btn-lg">Sign In</button>
-      </form>
-
-      <div class="auth-footer">
-        Don't have an account? <a href="/register">Create one</a>
-      </div>
-    </div>
-  </div>
-
-  <script>
-    if (localStorage.getItem('wab_token')) {
-      window.location.replace(typeof wabGetPostAuthRedirect === 'function' ? wabGetPostAuthRedirect() : '/dashboard');
-    }
-
-    document.getElementById('loginForm').addEventListener('submit', async (e) => {
-      e.preventDefault();
-      const errorEl = document.getElementById('errorAlert');
-      errorEl.style.display = 'none';
-
-      const email = document.getElementById('email').value;
-      const password = document.getElementById('password').value;
-
-      try {
-        const res = await fetch('/api/auth/login', {
-          method: 'POST',
-          headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify({ email, password })
-        });
-        const data = await res.json();
-
-        if (!res.ok) {
-          errorEl.textContent = data.error || 'Login failed';
-          errorEl.style.display = 'block';
-          return;
-        }
-
-        localStorage.setItem('wab_token', data.token);
-        localStorage.setItem('wab_user', JSON.stringify(data.user));
-        window.location.href = typeof wabGetPostAuthRedirect === 'function' ? wabGetPostAuthRedirect() : '/dashboard';
-      } catch (err) {
-        errorEl.textContent = 'Connection error. Please try again.';
-        errorEl.style.display = 'block';
-      }
-    });
-  </script>
-  <script src="/js/cookie-consent.js"></script>
-</body>
-</html>
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Sign In — Web Agent Bridge</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <style>body{background:#0a0e1a;color:#f0f4ff;font-family:Inter,-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;margin:0;min-height:100vh}</style>
+  <link rel="preload" href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&family=JetBrains+Mono:wght@400;500&display=swap" as="style" onload="this.onload=null;this.rel='stylesheet'">
+  <noscript><link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet"></noscript>
+  <link rel="stylesheet" href="/css/styles.css?v=3.0.1">
+  <script src="/js/auth-redirect.js?v=3.0.1"></script>
+</head>
+<body>
+  <div class="auth-page">
+    <div class="auth-card fade-in">
+      <div style="text-align:center; margin-bottom:32px;">
+        <a href="/" class="navbar-brand" style="justify-content:center;">
+          <div class="brand-icon">⚡</div>
+          <span>WAB</span>
+        </a>
+      </div>
+      <h1 style="text-align:center;">Welcome back</h1>
+      <p class="subtitle" style="text-align:center;">Sign in to your account</p>
+
+      <div class="alert alert-error" id="errorAlert"></div>
+
+      <form id="loginForm">
+        <div class="form-group">
+          <label for="email">Email</label>
+          <input type="email" id="email" class="form-input" placeholder="you@example.com" required>
+        </div>
+        <div class="form-group">
+          <label for="password">Password</label>
+          <input type="password" id="password" class="form-input" placeholder="Your password" required>
+        </div>
+        <button type="submit" class="btn btn-primary btn-lg">Sign In</button>
+      </form>
+
+      <div class="auth-footer">
+        Don't have an account? <a href="/register">Create one</a>
+      </div>
+    </div>
+  </div>
+
+  <script>
+    if (localStorage.getItem('wab_token')) {
+      window.location.replace(typeof wabGetPostAuthRedirect === 'function' ? wabGetPostAuthRedirect() : '/dashboard');
+    }
+
+    document.getElementById('loginForm').addEventListener('submit', async (e) => {
+      e.preventDefault();
+      const errorEl = document.getElementById('errorAlert');
+      errorEl.style.display = 'none';
+
+      const email = document.getElementById('email').value;
+      const password = document.getElementById('password').value;
+
+      try {
+        const res = await fetch('/api/auth/login', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ email, password })
+        });
+        const data = await res.json();
+
+        if (!res.ok) {
+          errorEl.textContent = data.error || 'Login failed';
+          errorEl.style.display = 'block';
+          return;
+        }
+
+        localStorage.setItem('wab_token', data.token);
+        localStorage.setItem('wab_user', JSON.stringify(data.user));
+        window.location.href = typeof wabGetPostAuthRedirect === 'function' ? wabGetPostAuthRedirect() : '/dashboard';
+      } catch (err) {
+        errorEl.textContent = 'Connection error. Please try again.';
+        errorEl.style.display = 'block';
+      }
+    });
+  </script>
+  <script src="/js/cookie-consent.js?v=3.0.1"></script>
+</body>
+</html>