web-agent-bridge 1.2.0 → 2.1.0

package/server/ws.js

@@ -1,101 +1,101 @@
-const WebSocket = require('ws');
-const { verifyUserToken, verifyAdminToken } = require('./config/secrets');
-const { findSiteById } = require('./models/db');
-
-// Map of siteId → Set of WebSocket clients
-const siteClients = new Map();
-
-function setupWebSocket(server) {
-  const wss = new WebSocket.Server({ server, path: '/ws/analytics' });
-
-  wss.on('connection', (ws, req) => {
-    let authenticatedSiteId = null;
-
-    ws.isAlive = true;
-    ws.on('pong', () => { ws.isAlive = true; });
-
-    ws.on('message', (data) => {
-      try {
-        const msg = JSON.parse(data);
-
-        if (msg.type === 'auth') {
-          if (!msg.token || !msg.siteId) {
-            ws.send(JSON.stringify({ type: 'error', message: 'token and siteId required' }));
-            return;
-          }
-
-          let decoded;
-          let isAdmin = false;
-          try {
-            decoded = verifyUserToken(msg.token);
-          } catch {
-            try {
-              decoded = verifyAdminToken(msg.token);
-              isAdmin = decoded.isAdmin === true;
-            } catch {
-              ws.send(JSON.stringify({ type: 'error', message: 'Invalid message or auth failed' }));
-              return;
-            }
-          }
-
-          if (!isAdmin) {
-            const site = findSiteById.get(msg.siteId);
-            if (!site || site.user_id !== decoded.id) {
-              ws.send(JSON.stringify({ type: 'error', message: 'Forbidden: not your site' }));
-              return;
-            }
-          }
-
-          authenticatedSiteId = msg.siteId;
-          if (!siteClients.has(msg.siteId)) {
-            siteClients.set(msg.siteId, new Set());
-          }
-          siteClients.get(msg.siteId).add(ws);
-          ws.send(JSON.stringify({ type: 'auth:success', siteId: msg.siteId }));
-        }
-      } catch (e) {
-        ws.send(JSON.stringify({ type: 'error', message: 'Invalid message or auth failed' }));
-      }
-    });
-
-    ws.on('close', () => {
-      if (authenticatedSiteId && siteClients.has(authenticatedSiteId)) {
-        siteClients.get(authenticatedSiteId).delete(ws);
-        if (siteClients.get(authenticatedSiteId).size === 0) {
-          siteClients.delete(authenticatedSiteId);
-        }
-      }
-    });
-  });
-
-  const interval = setInterval(() => {
-    wss.clients.forEach((ws) => {
-      if (!ws.isAlive) return ws.terminate();
-      ws.isAlive = false;
-      ws.ping();
-    });
-  }, 30000);
-
-  wss.on('close', () => clearInterval(interval));
-
-  return wss;
-}
-
-function broadcastAnalytic(siteId, eventData) {
-  const clients = siteClients.get(siteId);
-  if (!clients || clients.size === 0) return;
-
-  const message = JSON.stringify({
-    type: 'analytic',
-    timestamp: new Date().toISOString(),
-    ...eventData
-  });
-
-  clients.forEach((ws) => {
-    if (ws.readyState === WebSocket.OPEN) {
-      ws.send(message);
-    }
-  });
-}
-
-module.exports = { setupWebSocket, broadcastAnalytic };
+const WebSocket = require('ws');
+const { verifyUserToken, verifyAdminToken } = require('./config/secrets');
+const { findSiteById } = require('./models/db');
+
+// Map of siteId → Set of WebSocket clients
+const siteClients = new Map();
+
+function setupWebSocket(server) {
+  const wss = new WebSocket.Server({ server, path: '/ws/analytics' });
+
+  wss.on('connection', (ws, req) => {
+    let authenticatedSiteId = null;
+
+    ws.isAlive = true;
+    ws.on('pong', () => { ws.isAlive = true; });
+
+    ws.on('message', (data) => {
+      try {
+        const msg = JSON.parse(data);
+
+        if (msg.type === 'auth') {
+          if (!msg.token || !msg.siteId) {
+            ws.send(JSON.stringify({ type: 'error', message: 'token and siteId required' }));
+            return;
+          }
+
+          let decoded;
+          let isAdmin = false;
+          try {
+            decoded = verifyUserToken(msg.token);
+          } catch {
+            try {
+              decoded = verifyAdminToken(msg.token);
+              isAdmin = decoded.isAdmin === true;
+            } catch {
+              ws.send(JSON.stringify({ type: 'error', message: 'Invalid message or auth failed' }));
+              return;
+            }
+          }
+
+          if (!isAdmin) {
+            const site = findSiteById.get(msg.siteId);
+            if (!site || site.user_id !== decoded.id) {
+              ws.send(JSON.stringify({ type: 'error', message: 'Forbidden: not your site' }));
+              return;
+            }
+          }
+
+          authenticatedSiteId = msg.siteId;
+          if (!siteClients.has(msg.siteId)) {
+            siteClients.set(msg.siteId, new Set());
+          }
+          siteClients.get(msg.siteId).add(ws);
+          ws.send(JSON.stringify({ type: 'auth:success', siteId: msg.siteId }));
+        }
+      } catch (e) {
+        ws.send(JSON.stringify({ type: 'error', message: 'Invalid message or auth failed' }));
+      }
+    });
+
+    ws.on('close', () => {
+      if (authenticatedSiteId && siteClients.has(authenticatedSiteId)) {
+        siteClients.get(authenticatedSiteId).delete(ws);
+        if (siteClients.get(authenticatedSiteId).size === 0) {
+          siteClients.delete(authenticatedSiteId);
+        }
+      }
+    });
+  });
+
+  const interval = setInterval(() => {
+    wss.clients.forEach((ws) => {
+      if (!ws.isAlive) return ws.terminate();
+      ws.isAlive = false;
+      ws.ping();
+    });
+  }, 30000);
+
+  wss.on('close', () => clearInterval(interval));
+
+  return wss;
+}
+
+function broadcastAnalytic(siteId, eventData) {
+  const clients = siteClients.get(siteId);
+  if (!clients || clients.size === 0) return;
+
+  const message = JSON.stringify({
+    type: 'analytic',
+    timestamp: new Date().toISOString(),
+    ...eventData
+  });
+
+  clients.forEach((ws) => {
+    if (ws.readyState === WebSocket.OPEN) {
+      ws.send(message);
+    }
+  });
+}
+
+module.exports = { setupWebSocket, broadcastAnalytic };

package/templates/artisan-marketplace.yaml

@@ -0,0 +1,104 @@
+# WAB Agent Template — Artisan Marketplace Scout
+# Discovers handmade products from small artisans worldwide
+# Run: npx wab-agent run artisan-marketplace.yaml
+
+name: artisan-marketplace
+version: 1.0.0
+description: Discover and buy handmade products directly from artisans, not intermediaries
+author: WAB Community
+tags: [artisan, handmade, fair-trade, crafts, direct-buy]
+
+goal: >
+  Find WAB-enabled artisan shops, evaluate product authenticity and craftsmanship,
+  compare prices against mass-produced alternatives, negotiate fair prices that
+  support artisans, and verify product descriptions are accurate.
+
+target_sites:
+  discovery_method: wab-registry
+  category: artisan-crafts
+  region: global
+  fallback_urls: []
+
+parameters:
+  - name: product_type
+    type: string
+    required: true
+    description: "Type of handmade product (e.g. pottery, textiles, jewelry, leather)"
+  - name: origin_country
+    type: string
+    description: Preferred country of origin
+  - name: max_price
+    type: number
+    default: 500
+
+actions:
+  - name: discover
+    description: Find artisan shops selling the target product type
+    wab_action: discover
+
+  - name: browse_products
+    description: Browse available handmade products
+    wab_action: getProducts
+    params:
+      category: "{{product_type}}"
+      handmade: true
+
+  - name: verify_authenticity
+    description: Check product descriptions against photos
+    wab_action: verifyText
+    params:
+      fields: [material, origin, technique, dimensions]
+
+  - name: check_artisan_profile
+    description: Verify the artisan is a real person/workshop
+    wab_action: getArtisanProfile
+
+  - name: compare_prices
+    description: Compare with mass-produced alternatives for fair pricing
+    wab_action: getPrice
+    collect: true
+
+  - name: negotiate
+    description: Negotiate a fair price supporting the artisan
+    wab_action: negotiate
+    strategy: first_time
+    conditions:
+      proposed_discount: 5
+    fallback_strategy: instant_payment
+
+  - name: purchase
+    description: Purchase at agreed price
+    wab_action: buy
+    requires: [verify_authenticity]
+
+fairness_rules:
+  prefer_local: false
+  prefer_small_business: true
+  max_price: "{{max_price}}"
+  currency: USD
+  min_reputation_score: 30
+  avoid_monopolies: true
+  support_artisans: true
+
+negotiation:
+  enabled: true
+  max_rounds: 2
+  strategies:
+    - first_time
+    - instant_payment
+    - bulk_order
+  walk_away_threshold: 3
+  respect_artisan_floor: true
+
+verification:
+  anti_hallucination: true
+  cross_check_prices: true
+  verify_descriptions: true
+  require_vision_match: true
+  max_price_variance: 0.15
+
+output:
+  format: json
+  include: [artisan_name, product, material, origin, price, negotiated_price, authenticity_score, reputation]
+  sort_by: authenticity_score
+  limit: 15

package/templates/book-price-scout.yaml

@@ -0,0 +1,98 @@
+# WAB Agent Template — Book Price Scout
+# Finds the cheapest books directly from independent bookstores
+# Run: npx wab-agent run book-price-scout.yaml --title "Clean Code"
+
+name: book-price-scout
+version: 1.0.0
+description: Find books at the best price from independent bookstores, not just Amazon
+author: WAB Community
+tags: [books, price-comparison, indie-bookstore, shopping]
+
+goal: >
+  Search WAB-enabled independent bookstores for a specific book,
+  compare prices with Amazon, negotiate direct purchase discounts,
+  and verify book details are accurate.
+
+target_sites:
+  discovery_method: wab-registry
+  category: books
+  region: global
+  fallback_urls: []
+
+parameters:
+  - name: title
+    type: string
+    required: true
+  - name: author
+    type: string
+  - name: isbn
+    type: string
+  - name: format
+    type: string
+    default: paperback
+    enum: [paperback, hardcover, ebook]
+
+actions:
+  - name: discover
+    description: Find independent bookstores
+    wab_action: discover
+
+  - name: search_book
+    description: Search for the book
+    wab_action: searchProducts
+    params:
+      title: "{{title}}"
+      author: "{{author}}"
+      isbn: "{{isbn}}"
+    collect: true
+
+  - name: verify_details
+    description: Verify book title, author, edition match
+    wab_action: verifyText
+    require_pass: true
+
+  - name: verify_prices
+    description: Cross-check displayed prices
+    wab_action: verifyPrice
+    require_pass: true
+
+  - name: negotiate
+    description: Negotiate direct purchase discount
+    wab_action: negotiate
+    strategy: instant_payment
+    conditions:
+      proposed_discount: 8
+    fallback_strategy: first_time
+
+  - name: purchase
+    description: Buy the book
+    wab_action: buy
+    requires: [verify_details, verify_prices]
+
+fairness_rules:
+  prefer_local: true
+  prefer_small_business: true
+  currency: USD
+  min_reputation_score: 25
+  avoid_monopolies: true
+
+negotiation:
+  enabled: true
+  max_rounds: 2
+  strategies:
+    - instant_payment
+    - first_time
+    - bulk_order
+  walk_away_threshold: 3
+
+verification:
+  anti_hallucination: true
+  cross_check_prices: true
+  verify_descriptions: true
+  max_price_variance: 0.05
+
+output:
+  format: table
+  include: [bookstore, title, author, format, price, negotiated_price, shipping, total, reputation]
+  sort_by: total
+  limit: 10

package/templates/electronics-price-tracker.yaml

@@ -0,0 +1,108 @@
+# WAB Agent Template — Electronics Price Tracker
+# Monitors electronics prices and finds the best deal
+# Run: npx wab-agent run electronics-price-tracker.yaml --product "laptop" --max-price 1000
+
+name: electronics-price-tracker
+version: 1.0.0
+description: Track electronics prices across independent stores and find the best verified deal
+author: WAB Community
+tags: [electronics, price-tracking, shopping, deals, comparison]
+
+goal: >
+  Search WAB-enabled electronics retailers, track price history,
+  verify prices against screenshots, find the lowest verified price,
+  and negotiate bundle or loyalty discounts.
+
+target_sites:
+  discovery_method: wab-registry
+  category: electronics
+  region: auto
+  fallback_urls: []
+
+parameters:
+  - name: product
+    type: string
+    required: true
+    description: Product to search for
+  - name: max_price
+    type: number
+    required: true
+  - name: brand
+    type: string
+  - name: condition
+    type: string
+    default: new
+    enum: [new, refurbished, used]
+
+actions:
+  - name: discover
+    description: Find electronics stores
+    wab_action: discover
+
+  - name: search
+    description: Search for the product
+    wab_action: searchProducts
+    params:
+      query: "{{product}}"
+      brand: "{{brand}}"
+      condition: "{{condition}}"
+    collect: true
+
+  - name: verify_prices
+    description: Cross-verify all prices
+    wab_action: verifyPrice
+    require_pass: true
+
+  - name: check_specs
+    description: Verify product specifications match listing
+    wab_action: verifyText
+    params:
+      fields: [model, specs, warranty, condition]
+
+  - name: check_price_history
+    description: Check if current price is a real deal or inflated
+    wab_action: getPriceHistory
+    collect: true
+
+  - name: negotiate
+    description: Negotiate a discount
+    wab_action: negotiate
+    strategy: instant_payment
+    conditions:
+      proposed_discount: 7
+    fallback_strategy: first_time
+
+  - name: purchase
+    description: Buy at best verified price
+    wab_action: buy
+    requires: [verify_prices, check_specs]
+
+fairness_rules:
+  prefer_local: true
+  prefer_small_business: true
+  max_price: "{{max_price}}"
+  currency: USD
+  min_reputation_score: 45
+  avoid_monopolies: true
+
+negotiation:
+  enabled: true
+  max_rounds: 3
+  strategies:
+    - instant_payment
+    - first_time
+    - bulk_order
+  walk_away_threshold: 3
+
+verification:
+  anti_hallucination: true
+  cross_check_prices: true
+  require_vision_match: true
+  max_price_variance: 0.05
+  track_price_history: true
+
+output:
+  format: table
+  include: [store, product, brand, price, price_history_trend, negotiated_price, warranty, reputation, verified]
+  sort_by: price
+  limit: 15

package/templates/flight-deal-hunter.yaml

@@ -0,0 +1,113 @@
+# WAB Agent Template — Flight Deal Hunter
+# Finds flights directly from airline websites
+# Run: npx wab-agent run flight-deal-hunter.yaml --from "TUN" --to "CDG" --date "2026-06-15"
+
+name: flight-deal-hunter
+version: 1.0.0
+description: Find flight deals directly from airline websites, bypassing aggregator markups
+author: WAB Community
+tags: [travel, flights, airline, direct-booking, savings]
+
+goal: >
+  Search WAB-enabled airline websites for direct flight bookings,
+  compare with aggregator prices, verify fares include all taxes,
+  and book at the best direct price.
+
+target_sites:
+  discovery_method: wab-registry
+  category: airlines
+  region: global
+  fallback_urls: []
+
+parameters:
+  - name: from
+    type: string
+    required: true
+    description: Departure airport code (IATA)
+  - name: to
+    type: string
+    required: true
+    description: Arrival airport code (IATA)
+  - name: date
+    type: date
+    required: true
+  - name: return_date
+    type: date
+  - name: passengers
+    type: number
+    default: 1
+  - name: class
+    type: string
+    default: economy
+    enum: [economy, business, first]
+
+actions:
+  - name: discover
+    description: Find airlines serving this route
+    wab_action: discover
+
+  - name: search_flights
+    description: Search for available flights
+    wab_action: searchFlights
+    params:
+      from: "{{from}}"
+      to: "{{to}}"
+      date: "{{date}}"
+      return_date: "{{return_date}}"
+      passengers: "{{passengers}}"
+      class: "{{class}}"
+    collect: true
+
+  - name: verify_fares
+    description: Verify displayed fares include all taxes and fees
+    wab_action: verifyPrice
+    require_pass: true
+
+  - name: check_total_price
+    description: Confirm total price matches breakdown
+    wab_action: verifyText
+    params:
+      fields: [base_fare, taxes, fees, total]
+    require_pass: true
+
+  - name: negotiate
+    description: Try to get a direct-booking discount
+    wab_action: negotiate
+    strategy: instant_payment
+    conditions:
+      proposed_discount: 3
+    fallback_strategy: off_peak
+
+  - name: book
+    description: Book the flight
+    wab_action: bookFlight
+    requires: [verify_fares, check_total_price]
+
+fairness_rules:
+  prefer_local: false
+  prefer_small_business: false
+  currency: auto
+  min_reputation_score: 60
+  avoid_monopolies: false
+  price_transparency: true
+
+negotiation:
+  enabled: true
+  max_rounds: 2
+  strategies:
+    - instant_payment
+    - off_peak
+  walk_away_threshold: 1
+
+verification:
+  anti_hallucination: true
+  cross_check_prices: true
+  require_vision_match: true
+  max_price_variance: 0.02
+  verify_tax_inclusion: true
+
+output:
+  format: table
+  include: [airline, flight_number, departure, arrival, duration, stops, fare, total_with_taxes, verification]
+  sort_by: total_with_taxes
+  limit: 20