web-agent-bridge 2.3.0 → 2.4.0

package/server/services/agent-tasks.js

@@ -0,0 +1,1807 @@
+/**
+ * WAB Agent Tasks — Autonomous Task Orchestration Engine
+ *
+ * The brain behind WAB's autonomous agent. When a user says "احجز لي تذكرة طيران"
+ * or "Book me a flight", this service:
+ *   1. Understands the intent and decomposes it into steps
+ *   2. Dispatches agents to search, compare, negotiate across trusted sites
+ *   3. Streams progress back to the user in real-time
+ *   4. Presents offers with negotiation details (price, source, savings)
+ *   5. Asks clarifying questions when needed
+ *   6. Executes the final action on user approval
+ *
+ * Works with: swarm.js (multi-agent), agent-mesh.js (P2P coordination),
+ *             commander.js (mission decomposition), agent-chat.js (AI backbone)
+ */
+
+const crypto = require('crypto');
+const { db } = require('../models/db');
+
+// ─── Schema ──────────────────────────────────────────────────────────
+
+db.exec(`
+  CREATE TABLE IF NOT EXISTS agent_tasks (
+    id TEXT PRIMARY KEY,
+    session_id TEXT NOT NULL,
+    intent TEXT NOT NULL,
+    category TEXT DEFAULT 'general',
+    status TEXT DEFAULT 'understanding' CHECK(status IN (
+      'understanding','clarifying','planning','searching','negotiating',
+      'comparing','presenting','awaiting_approval','executing','completed','failed','cancelled'
+    )),
+    original_message TEXT NOT NULL,
+    parsed_requirements TEXT DEFAULT '{}',
+    clarifications TEXT DEFAULT '[]',
+    plan TEXT DEFAULT '[]',
+    current_step INTEGER DEFAULT 0,
+    offers TEXT DEFAULT '[]',
+    selected_offer TEXT,
+    result TEXT DEFAULT '{}',
+    created_at TEXT DEFAULT (datetime('now')),
+    updated_at TEXT DEFAULT (datetime('now'))
+  );
+
+  CREATE TABLE IF NOT EXISTS task_agents (
+    id TEXT PRIMARY KEY,
+    task_id TEXT NOT NULL,
+    agent_name TEXT NOT NULL,
+    role TEXT DEFAULT 'searcher',
+    target_url TEXT,
+    status TEXT DEFAULT 'idle' CHECK(status IN ('idle','searching','negotiating','done','failed')),
+    progress INTEGER DEFAULT 0,
+    findings TEXT DEFAULT '{}',
+    negotiation_log TEXT DEFAULT '[]',
+    best_offer TEXT DEFAULT '{}',
+    started_at TEXT,
+    completed_at TEXT,
+    FOREIGN KEY (task_id) REFERENCES agent_tasks(id) ON DELETE CASCADE
+  );
+
+  CREATE TABLE IF NOT EXISTS task_messages (
+    id TEXT PRIMARY KEY,
+    task_id TEXT NOT NULL,
+    role TEXT NOT NULL CHECK(role IN ('system','agent','user','offer')),
+    content TEXT NOT NULL,
+    metadata TEXT DEFAULT '{}',
+    created_at TEXT DEFAULT (datetime('now')),
+    FOREIGN KEY (task_id) REFERENCES agent_tasks(id) ON DELETE CASCADE
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_tasks_session ON agent_tasks(session_id);
+  CREATE INDEX IF NOT EXISTS idx_tasks_status ON agent_tasks(status);
+  CREATE INDEX IF NOT EXISTS idx_task_agents_task ON task_agents(task_id);
+  CREATE INDEX IF NOT EXISTS idx_task_messages_task ON task_messages(task_id);
+`);
+
+// ─── Prepared Statements ─────────────────────────────────────────────
+
+const stmts = {
+  insertTask: db.prepare(`INSERT INTO agent_tasks
+    (id, session_id, intent, category, status, original_message, parsed_requirements)
+    VALUES (?, ?, ?, ?, ?, ?, ?)`),
+  getTask: db.prepare('SELECT * FROM agent_tasks WHERE id = ?'),
+  getTasksBySession: db.prepare('SELECT * FROM agent_tasks WHERE session_id = ? ORDER BY created_at DESC LIMIT ?'),
+  updateTask: db.prepare(`UPDATE agent_tasks SET status=?, parsed_requirements=?,
+    clarifications=?, plan=?, current_step=?, offers=?, selected_offer=?,
+    result=?, updated_at=datetime('now') WHERE id=?`),
+  updateTaskStatus: db.prepare(`UPDATE agent_tasks SET status=?, updated_at=datetime('now') WHERE id=?`),
+
+  insertAgent: db.prepare(`INSERT INTO task_agents
+    (id, task_id, agent_name, role, target_url, status) VALUES (?, ?, ?, ?, ?, ?)`),
+  getAgents: db.prepare('SELECT * FROM task_agents WHERE task_id = ? ORDER BY started_at'),
+  updateAgent: db.prepare(`UPDATE task_agents SET status=?, progress=?,
+    findings=?, negotiation_log=?, best_offer=?, started_at=COALESCE(started_at,?),
+    completed_at=? WHERE id=?`),
+
+  insertMessage: db.prepare(`INSERT INTO task_messages (id, task_id, role, content, metadata) VALUES (?, ?, ?, ?, ?)`),
+  getMessages: db.prepare('SELECT * FROM task_messages WHERE task_id = ? ORDER BY created_at'),
+};
+
+// ─── Intent Recognition ──────────────────────────────────────────────
+
+// ─── URL Booking Parser ──────────────────────────────────────────────
+
+/**
+ * Detect if a message contains a booking/product URL and parse it.
+ * Supports: Booking.com, Hotels.com, Expedia, Agoda, Airbnb, Amazon, eBay,
+ *           Kayak, Skyscanner, Google Flights/Hotels, TripAdvisor
+ */
+function parseBookingUrl(message) {
+  // Extract URL from message
+  const urlMatch = message.match(/https?:\/\/[^\s,،"'<>]+/i);
+  if (!urlMatch) return null;
+
+  const rawUrl = urlMatch[0].replace(/[,،.]+$/, ''); // strip trailing punctuation
+  let parsed;
+  try { parsed = new URL(rawUrl); } catch (_) { return null; }
+
+  const host = parsed.hostname.replace(/^www\./, '').toLowerCase();
+  const params = Object.fromEntries(parsed.searchParams.entries());
+  const path = parsed.pathname;
+
+  const result = {
+    url: rawUrl,
+    host,
+    params,
+    path,
+    site: null,
+    type: null,           // 'hotel', 'flight', 'product', 'rental'
+    name: null,           // Hotel/product name from URL slug
+    checkin: null,
+    checkout: null,
+    adults: null,
+    children: null,
+    rooms: null,
+    destination: null,
+    price: null,          // Will be populated if visible in URL
+    currency: null,
+    extras: {},
+  };
+
+  // ── Booking.com ──
+  if (host.includes('booking.com')) {
+    result.site = 'Booking.com';
+    result.type = path.includes('/hotel/') ? 'hotel' : 'hotel_search';
+
+    // Extract hotel name from path: /hotel/de/hotel-name-slug.ar.html
+    const hotelSlug = path.match(/\/hotel\/[a-z]{2}\/([^.]+)/);
+    if (hotelSlug) {
+      result.name = hotelSlug[1].replace(/-/g, ' ').replace(/\b\w/g, c => c.toUpperCase());
+    }
+
+    result.checkin = params.checkin || params.checkin_monthday || null;
+    result.checkout = params.checkout || params.checkout_monthday || null;
+    result.adults = parseInt(params.group_adults || params.req_adults) || null;
+    result.children = parseInt(params.group_children || params.req_children) || null;
+    result.rooms = parseInt(params.no_rooms) || null;
+    result.destination = params.ss || params.dest_id || null;
+
+    // Extract city from dest_type + path
+    const countryCode = path.match(/\/hotel\/([a-z]{2})\//);
+    if (countryCode) result.extras.country = countryCode[1].toUpperCase();
+  }
+
+  // ── Hotels.com ──
+  else if (host.includes('hotels.com')) {
+    result.site = 'Hotels.com';
+    result.type = 'hotel';
+    result.checkin = params.chkin || params.checkIn || null;
+    result.checkout = params.chkout || params.checkOut || null;
+    result.adults = parseInt(params.adults) || null;
+    result.children = parseInt(params.children) || null;
+    result.rooms = parseInt(params.rooms) || null;
+    result.destination = params.destination || params.q || null;
+
+    const hotelSlug = path.match(/\/ho(\d+)/);
+    if (hotelSlug) result.extras.hotelId = hotelSlug[1];
+  }
+
+  // ── Expedia ──
+  else if (host.includes('expedia.com')) {
+    result.site = 'Expedia';
+    result.type = path.includes('/Hotel') ? 'hotel' : path.includes('/Flight') ? 'flight' : 'travel';
+    result.checkin = params.chkin || params.startDate || null;
+    result.checkout = params.chkout || params.endDate || null;
+    result.adults = parseInt(params.adults) || null;
+    result.children = parseInt(params.children) || null;
+    result.rooms = parseInt(params.rooms) || null;
+    result.destination = params.destination || null;
+  }
+
+  // ── Agoda ──
+  else if (host.includes('agoda.com')) {
+    result.site = 'Agoda';
+    result.type = 'hotel';
+    result.checkin = params.checkIn || null;
+    result.checkout = params.checkOut || null;
+    result.adults = parseInt(params.adults) || null;
+    result.children = parseInt(params.children) || null;
+    result.rooms = parseInt(params.rooms) || null;
+  }
+
+  // ── Airbnb ──
+  else if (host.includes('airbnb.com') || host.includes('airbnb.')) {
+    result.site = 'Airbnb';
+    result.type = 'rental';
+    result.checkin = params.check_in || null;
+    result.checkout = params.check_out || null;
+    result.adults = parseInt(params.adults) || null;
+    result.children = parseInt(params.children) || null;
+
+    const listingMatch = path.match(/\/rooms\/(\d+)/);
+    if (listingMatch) result.extras.listingId = listingMatch[1];
+  }
+
+  // ── Amazon ──
+  else if (host.includes('amazon.')) {
+    result.site = 'Amazon';
+    result.type = 'product';
+    const asinMatch = path.match(/\/dp\/([A-Z0-9]{10})/) || path.match(/\/gp\/product\/([A-Z0-9]{10})/);
+    if (asinMatch) result.extras.asin = asinMatch[1];
+    const titleMatch = path.match(/\/([\w-]+)\/dp/);
+    if (titleMatch) result.name = titleMatch[1].replace(/-/g, ' ');
+    result.destination = params.k || params.keywords || null;
+  }
+
+  // ── Kayak ──
+  else if (host.includes('kayak.com')) {
+    result.site = 'Kayak';
+    result.type = path.includes('/hotels') ? 'hotel' : 'flight';
+    // Kayak uses path-based params: /flights/TUN-IST/2026-04-12/2026-04-13
+    const flightParts = path.match(/\/flights\/([A-Z]{3})-([A-Z]{3})\/(\d{4}-\d{2}-\d{2})(?:\/(\d{4}-\d{2}-\d{2}))?/);
+    if (flightParts) {
+      result.extras.origin = flightParts[1];
+      result.extras.destCode = flightParts[2];
+      result.checkin = flightParts[3];
+      result.checkout = flightParts[4] || null;
+    }
+    result.adults = parseInt(params.adults) || null;
+  }
+
+  // ── Skyscanner ──
+  else if (host.includes('skyscanner.')) {
+    result.site = 'Skyscanner';
+    result.type = 'flight';
+    // Path: /transport/flights/tun/ist/260412/260413/
+    const skyParts = path.match(/\/flights\/([a-z]+)\/([a-z]+)\/(\d{6})(?:\/(\d{6}))?/);
+    if (skyParts) {
+      result.extras.origin = skyParts[1].toUpperCase();
+      result.extras.destCode = skyParts[2].toUpperCase();
+    }
+    result.adults = parseInt(params.adults) || null;
+  }
+
+  // ── Google Hotels / Flights ──
+  else if (host.includes('google.com') && (path.includes('/travel') || path.includes('/flights'))) {
+    result.site = 'Google Travel';
+    result.type = path.includes('/hotels') ? 'hotel' : 'flight';
+    result.destination = params.q || null;
+  }
+
+  // ── TripAdvisor ──
+  else if (host.includes('tripadvisor.')) {
+    result.site = 'TripAdvisor';
+    result.type = path.includes('/Hotel') ? 'hotel' : path.includes('/Restaurant') ? 'food' : 'travel';
+    const nameMatch = path.match(/Reviews-([^-]+(?:-[^-]+)*)-/);
+    if (nameMatch) result.name = nameMatch[1].replace(/_/g, ' ');
+  }
+
+  // ── Generic (unknown site with URL params) ──
+  else {
+    result.site = host.split('.').slice(-2, -1)[0]; // e.g. "somesite" from somesite.com
+    result.site = result.site.charAt(0).toUpperCase() + result.site.slice(1);
+    result.type = 'unknown';
+    // Try to extract common params
+    result.checkin = params.checkin || params.check_in || params.startDate || params.from || null;
+    result.checkout = params.checkout || params.check_out || params.endDate || params.to || null;
+    result.adults = parseInt(params.adults || params.guests) || null;
+  }
+
+  // Only return if we detected a real booking/product site
+  if (!result.site) return null;
+
+  return result;
+}
+
+/**
+ * Create a URL-based negotiation task. Skips clarification and
+ * immediately searches for better prices across competing sites.
+ */
+function createUrlTask(sessionId, message, urlData) {
+  const id = crypto.randomUUID();
+  const lang = _detectLang(message);
+
+  // Determine category from URL type
+  const categoryMap = { hotel: 'travel', flight: 'travel', hotel_search: 'travel',
+    rental: 'travel', product: 'shopping', food: 'food', travel: 'travel', unknown: 'general' };
+  const category = categoryMap[urlData.type] || 'general';
+
+  // Build requirements from parsed URL
+  const reqs = {
+    raw: message,
+    intent: urlData.type === 'product' ? 'shopping' : (urlData.type === 'flight' ? 'flight' : 'hotel'),
+    category,
+    sourceUrl: urlData.url,
+    sourceSite: urlData.site,
+    urlData,
+    name: urlData.name,
+    dates: [urlData.checkin, urlData.checkout].filter(Boolean),
+    locations: [urlData.destination, urlData.extras?.origin, urlData.extras?.destCode].filter(Boolean),
+    quantity: urlData.adults ? { count: urlData.adults, unit: 'person' } : { count: 1, unit: 'person' },
+    rooms: urlData.rooms || 1,
+    children: urlData.children || 0,
+  };
+
+  // Build the URL negotiation plan
+  const plan = _buildUrlNegotiationPlan(urlData, lang);
+
+  stmts.insertTask.run(id, sessionId, reqs.intent, category,
+    'planning', message, JSON.stringify(reqs));
+
+  _addMessage(id, 'user', message);
+
+  // Build summary of what was extracted
+  const summary = _urlSummary(urlData, lang);
+  _addMessage(id, 'agent', summary, { type: 'url_parsed', urlData });
+
+  _updatePlan(id, plan);
+
+  return {
+    taskId: id,
+    status: 'planning',
+    intent: { intent: reqs.intent, category, confidence: 1.0 },
+    requirements: reqs,
+    plan,
+    urlData,
+    message: summary + '\n\n' + _planSummary(plan, lang),
+  };
+}
+
+/**
+ * Execute URL negotiation — fetch the original page price,
+ * then search competing sites for the same item at lower prices.
+ */
+async function executeUrlTask(taskId) {
+  const task = stmts.getTask.get(taskId);
+  if (!task) return { error: 'Task not found' };
+
+  const reqs = JSON.parse(task.parsed_requirements || '{}');
+  const urlData = reqs.urlData;
+  if (!urlData) return executeTask(taskId); // Fallback to normal
+
+  const plan = JSON.parse(task.plan || '[]');
+  const lang = _detectLang(task.original_message);
+  const updates = [];
+
+  // ── Step 1: Analyze original listing ──
+  stmts.updateTaskStatus.run('searching', taskId);
+
+  const analyzeMsg = lang === 'ar'
+    ? `🔍 أحلل الصفحة الأصلية من ${urlData.site}...\n📌 ${urlData.name || urlData.url}`
+    : `🔍 Analyzing original listing from ${urlData.site}...\n📌 ${urlData.name || urlData.url}`;
+  _addMessage(taskId, 'agent', analyzeMsg, { type: 'progress', step: 'analyze' });
+  updates.push({ type: 'progress', step: 'analyze', message: analyzeMsg });
+
+  // Try to fetch the original page to get the current price
+  let originalPrice = null;
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 12000);
+    const res = await fetch(urlData.url, {
+      headers: {
+        'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36',
+        'Accept': 'text/html',
+        'Accept-Language': 'ar,en-US;q=0.9,en;q=0.8',
+      },
+      signal: controller.signal,
+      redirect: 'follow',
+    });
+    clearTimeout(timeout);
+
+    if (res.ok) {
+      const html = await res.text();
+      // Extract prices from the page
+      const priceRegex = /(?:€|EUR|\$|USD|SAR|ريال|£|GBP)\s*[\d,]+\.?\d*|[\d,]+\.?\d*\s*(?:€|EUR|\$|USD|SAR|ريال|£|GBP)/g;
+      const prices = (html.match(priceRegex) || [])
+        .map(p => ({ raw: p, num: parseFloat(p.replace(/[^\d.]/g, '')) }))
+        .filter(p => p.num > 10 && p.num < 50000)
+        .sort((a, b) => a.num - b.num);
+
+      if (prices.length > 0) {
+        originalPrice = prices[0]; // Lowest price on the page
+      }
+
+      // Also try to extract title if we don't have a name
+      if (!urlData.name) {
+        const titleMatch = html.match(/<title[^>]*>([^<]+)<\/title>/i);
+        if (titleMatch) {
+          urlData.name = titleMatch[1].replace(/\s*[-|–—].*$/, '').trim().slice(0, 80);
+        }
+      }
+    }
+  } catch (_) { /* Fetch failed, continue with competing search */ }
+
+  const priceMsg = originalPrice
+    ? (lang === 'ar'
+      ? `💰 السعر الحالي في ${urlData.site}: **${originalPrice.raw}**\n🎯 أبحث عن أسعار أفضل...`
+      : `💰 Current price on ${urlData.site}: **${originalPrice.raw}**\n🎯 Searching for better prices...`)
+    : (lang === 'ar'
+      ? `💰 لم أتمكن من قراءة السعر مباشرةً. سأبحث في مصادر بديلة...`
+      : `💰 Couldn't read the price directly. Searching alternative sources...`);
+  _addMessage(taskId, 'agent', priceMsg, { type: 'progress', step: 'price_check' });
+  updates.push({ type: 'progress', step: 'price_check', message: priceMsg });
+
+  // ── Step 2: Search competing sources ──
+  const category = task.category || 'travel';
+  const competingSources = _getCompetingSources(urlData, category);
+
+  const searchMsg = lang === 'ar'
+    ? `🚀 أبحث في ${competingSources.length} مصادر منافسة...\n${competingSources.map(s => `  • ${s.name}`).join('\n')}`
+    : `🚀 Searching ${competingSources.length} competing sources...\n${competingSources.map(s => `  • ${s.name}`).join('\n')}`;
+  _addMessage(taskId, 'agent', searchMsg, { type: 'progress', step: 'search' });
+  updates.push({ type: 'progress', step: 'search', message: searchMsg });
+
+  // Create search agents
+  const agents = [];
+  for (const source of competingSources) {
+    const agentId = crypto.randomUUID();
+    stmts.insertAgent.run(agentId, taskId, `${source.name} Agent`, 'negotiator', source.url, 'idle');
+    agents.push({ id: agentId, source });
+  }
+
+  // Build search query from URL data
+  const searchQuery = [
+    urlData.name,
+    urlData.destination,
+    urlData.extras?.origin,
+    urlData.extras?.destCode,
+    urlData.type === 'hotel' ? 'hotel' : urlData.type === 'flight' ? 'flights' : '',
+    urlData.checkin,
+  ].filter(Boolean).join(' ');
+
+  // Execute searches
+  const searchResults = await Promise.allSettled(
+    agents.map(a => _executeSearchAgent(a.id, a.source, {
+      ...reqs,
+      raw: searchQuery,
+    }, searchQuery))
+  );
+
+  // Collect all findings
+  const allFindings = [];
+
+  // Add the original listing as the baseline
+  allFindings.push({
+    source: urlData.site + ' (original)',
+    url: urlData.url,
+    title: urlData.name || `Original listing on ${urlData.site}`,
+    price: originalPrice ? originalPrice.raw : null,
+    priceNum: originalPrice ? originalPrice.num : null,
+    description: `Your original ${urlData.type} from ${urlData.site}`,
+    type: 'original',
+    rank: 0,
+    isOriginal: true,
+  });
+
+  for (let i = 0; i < searchResults.length; i++) {
+    const result = searchResults[i];
+    if (result.status === 'fulfilled' && result.value) {
+      allFindings.push(...result.value);
+    }
+  }
+
+  // ── Step 3: Compare & negotiate ──
+  stmts.updateTaskStatus.run('negotiating', taskId);
+
+  const negMsg = lang === 'ar'
+    ? `🤝 أقارن ${allFindings.length} عرض وأتفاوض للحصول على أفضل سعر...`
+    : `🤝 Comparing ${allFindings.length} offers and negotiating for the best price...`;
+  _addMessage(taskId, 'agent', negMsg, { type: 'progress', step: 'negotiate' });
+  updates.push({ type: 'progress', step: 'negotiate', message: negMsg });
+
+  // Rank with the original price as reference
+  const ranked = _rankFindings(allFindings, reqs);
+
+  // Apply negotiation analysis with reference to original price
+  for (const offer of ranked.slice(0, 8)) {
+    offer.negotiation = _negotiateUrlOffer(offer, originalPrice, urlData, reqs);
+  }
+
+  // ── Step 4: Present results ──
+  stmts.updateTaskStatus.run('presenting', taskId);
+  const topOffers = ranked.slice(0, 8);
+
+  stmts.updateTask.run('presenting', JSON.stringify(reqs),
+    task.clarifications, task.plan, plan.length,
+    JSON.stringify(topOffers), null, task.result, taskId);
+
+  const offerMsg = _formatUrlOffers(topOffers, urlData, originalPrice, lang);
+  _addMessage(taskId, 'agent', offerMsg, { type: 'offers', offers: topOffers });
+  updates.push({ type: 'offers', message: offerMsg, offers: topOffers });
+
+  return {
+    taskId,
+    status: 'presenting',
+    offers: topOffers,
+    message: offerMsg,
+    updates,
+    totalFound: allFindings.length,
+    originalPrice: originalPrice ? originalPrice.raw : null,
+    urlData,
+  };
+}
+
+/**
+ * Get competing sources for a given URL (exclude the original site).
+ */
+function _getCompetingSources(urlData, category) {
+  const sources = [];
+  const originalHost = urlData.host;
+
+  // Hotel-specific competitors
+  if (urlData.type === 'hotel' || urlData.type === 'hotel_search' || urlData.type === 'rental') {
+    const hotelSources = [
+      { name: 'Booking.com', url: 'https://www.booking.com', type: 'direct' },
+      { name: 'Hotels.com', url: 'https://www.hotels.com', type: 'direct' },
+      { name: 'Agoda', url: 'https://www.agoda.com', type: 'direct' },
+      { name: 'Expedia', url: 'https://www.expedia.com', type: 'aggregator' },
+      { name: 'Kayak', url: 'https://www.kayak.com', type: 'aggregator' },
+      { name: 'TripAdvisor', url: 'https://www.tripadvisor.com', type: 'review' },
+      { name: 'Google Hotels', url: 'https://www.google.com/travel/hotels', type: 'search' },
+      { name: 'Trivago', url: 'https://www.trivago.com', type: 'aggregator' },
+    ];
+    for (const s of hotelSources) {
+      if (!originalHost.includes(s.name.toLowerCase().replace(/[.\s]/g, ''))) {
+        sources.push(s);
+      }
+    }
+  }
+
+  // Flight competitors
+  else if (urlData.type === 'flight') {
+    const flightSources = [
+      { name: 'Kayak', url: 'https://www.kayak.com', type: 'aggregator' },
+      { name: 'Skyscanner', url: 'https://www.skyscanner.com', type: 'aggregator' },
+      { name: 'Google Flights', url: 'https://www.google.com/travel/flights', type: 'search' },
+      { name: 'Wego', url: 'https://www.wego.com', type: 'aggregator' },
+      { name: 'Momondo', url: 'https://www.momondo.com', type: 'aggregator' },
+      { name: 'Kiwi', url: 'https://www.kiwi.com', type: 'aggregator' },
+    ];
+    for (const s of flightSources) {
+      if (!originalHost.includes(s.name.toLowerCase().replace(/[.\s]/g, ''))) {
+        sources.push(s);
+      }
+    }
+  }
+
+  // Product competitors
+  else if (urlData.type === 'product') {
+    const productSources = [
+      { name: 'Google Shopping', url: 'https://shopping.google.com', type: 'search' },
+      { name: 'Amazon', url: 'https://www.amazon.com', type: 'direct' },
+      { name: 'eBay', url: 'https://www.ebay.com', type: 'marketplace' },
+      { name: 'PriceGrabber', url: 'https://www.pricegrabber.com', type: 'aggregator' },
+      { name: 'CamelCamelCamel', url: 'https://camelcamelcamel.com', type: 'price_tracker' },
+    ];
+    for (const s of productSources) {
+      if (!originalHost.includes(s.name.toLowerCase().replace(/[.\s]/g, ''))) {
+        sources.push(s);
+      }
+    }
+  }
+
+  // Fallback: use general sources
+  if (sources.length === 0) {
+    sources.push(
+      { name: 'Google', url: 'https://www.google.com', type: 'search' },
+      { name: 'DuckDuckGo', url: 'https://duckduckgo.com', type: 'search' },
+    );
+  }
+
+  return sources.slice(0, 6);
+}
+
+/**
+ * Build execution plan specifically for URL negotiation.
+ */
+function _buildUrlNegotiationPlan(urlData, lang) {
+  return [
+    {
+      id: 1,
+      action: 'analyze',
+      description_ar: `🔍 تحليل الصفحة الأصلية من ${urlData.site}`,
+      description_en: `🔍 Analyzing original listing from ${urlData.site}`,
+      status: 'pending',
+    },
+    {
+      id: 2,
+      action: 'search',
+      description_ar: '🌐 البحث في مصادر منافسة عن نفس العرض بسعر أقل',
+      description_en: '🌐 Searching competing sources for the same deal at lower prices',
+      status: 'pending',
+    },
+    {
+      id: 3,
+      action: 'negotiate',
+      description_ar: '🤝 مقارنة الأسعار والتفاوض',
+      description_en: '🤝 Comparing prices and negotiating',
+      status: 'pending',
+    },
+    {
+      id: 4,
+      action: 'present',
+      description_ar: '📋 عرض أفضل العروض والتوفير المحتمل',
+      description_en: '📋 Presenting best offers and potential savings',
+      status: 'pending',
+    },
+  ];
+}
+
+/**
+ * Build a human-readable summary of the parsed URL.
+ */
+function _urlSummary(urlData, lang) {
+  const parts = [];
+
+  if (lang === 'ar') {
+    parts.push(`🔗 **فهمت!** رابط من **${urlData.site}**`);
+    if (urlData.name) parts.push(`📌 ${urlData.name}`);
+    if (urlData.type === 'hotel') parts.push(`🏨 نوع: فندق`);
+    else if (urlData.type === 'flight') parts.push(`✈️ نوع: رحلة طيران`);
+    else if (urlData.type === 'product') parts.push(`🛒 نوع: منتج`);
+    else if (urlData.type === 'rental') parts.push(`🏠 نوع: سكن`);
+    if (urlData.checkin && urlData.checkout) parts.push(`📅 ${urlData.checkin} → ${urlData.checkout}`);
+    else if (urlData.checkin) parts.push(`📅 ${urlData.checkin}`);
+    if (urlData.adults) parts.push(`👥 ${urlData.adults} بالغ${urlData.children ? ` + ${urlData.children} أطفال` : ''}`);
+    if (urlData.rooms && urlData.rooms > 1) parts.push(`🚪 ${urlData.rooms} غرف`);
+    parts.push('');
+    parts.push('🤖 سأبحث في مصادر منافسة للحصول على سعر أفضل بنفس المعلومات...');
+  } else {
+    parts.push(`🔗 **Got it!** Link from **${urlData.site}**`);
+    if (urlData.name) parts.push(`📌 ${urlData.name}`);
+    if (urlData.type === 'hotel') parts.push(`🏨 Type: Hotel`);
+    else if (urlData.type === 'flight') parts.push(`✈️ Type: Flight`);
+    else if (urlData.type === 'product') parts.push(`🛒 Type: Product`);
+    else if (urlData.type === 'rental') parts.push(`🏠 Type: Rental`);
+    if (urlData.checkin && urlData.checkout) parts.push(`📅 ${urlData.checkin} → ${urlData.checkout}`);
+    else if (urlData.checkin) parts.push(`📅 ${urlData.checkin}`);
+    if (urlData.adults) parts.push(`👥 ${urlData.adults} adult${urlData.adults > 1 ? 's' : ''}${urlData.children ? ` + ${urlData.children} children` : ''}`);
+    if (urlData.rooms && urlData.rooms > 1) parts.push(`🚪 ${urlData.rooms} room${urlData.rooms > 1 ? 's' : ''}`);
+    parts.push('');
+    parts.push('🤖 Searching competing sources for a better price with the same details...');
+  }
+
+  return parts.join('\n');
+}
+
+/**
+ * Negotiate an offer relative to the original URL price.
+ */
+function _negotiateUrlOffer(offer, originalPrice, urlData, reqs) {
+  const lang = _detectLang(reqs.raw);
+  const negotiation = {
+    originalPrice: originalPrice ? originalPrice.raw : null,
+    originalPriceNum: originalPrice ? originalPrice.num : null,
+    negotiatedPrice: offer.price,
+    savings: null,
+    savingsPercent: 0,
+    strategy: 'url_comparison',
+    tip: '',
+    log: [],
+  };
+
+  if (offer.isOriginal) {
+    negotiation.strategy = 'original';
+    negotiation.tip = lang === 'ar'
+      ? '📌 هذا هو السعر الأصلي من رابطك'
+      : '📌 This is the original price from your link';
+    negotiation.log.push(lang === 'ar'
+      ? '📌 العرض الأصلي — قارن مع البدائل أدناه'
+      : '📌 Original listing — compare with alternatives below');
+    return negotiation;
+  }
+
+  // Calculate savings vs original
+  if (originalPrice && offer.priceNum) {
+    const diff = originalPrice.num - offer.priceNum;
+    if (diff > 0) {
+      negotiation.savings = diff.toFixed(2);
+      negotiation.savingsPercent = Math.round((diff / originalPrice.num) * 100);
+      negotiation.log.push(lang === 'ar'
+        ? `🎯 أرخص من ${urlData.site} بـ ${diff.toFixed(0)} (${negotiation.savingsPercent}% توفير)`
+        : `🎯 Cheaper than ${urlData.site} by ${diff.toFixed(0)} (${negotiation.savingsPercent}% savings)`);
+    } else if (diff < 0) {
+      negotiation.log.push(lang === 'ar'
+        ? `⬆️ أغلى من ${urlData.site} بـ ${Math.abs(diff).toFixed(0)}`
+        : `⬆️ More expensive than ${urlData.site} by ${Math.abs(diff).toFixed(0)}`);
+    } else {
+      negotiation.log.push(lang === 'ar'
+        ? `↔️ نفس السعر على ${urlData.site}`
+        : `↔️ Same price as ${urlData.site}`);
+    }
+  }
+
+  // Strategy tips
+  if (offer.type === 'aggregator') {
+    negotiation.tip = lang === 'ar'
+      ? '💡 موقع تجميع — قد يجد أسعاراً أقل من حجز مباشر'
+      : '💡 Aggregator — may find prices lower than direct booking';
+  } else if (offer.type === 'direct') {
+    negotiation.tip = lang === 'ar'
+      ? '💡 حجز مباشر — ابحث عن كوبونات أو برامج ولاء'
+      : '💡 Direct booking — look for coupons or loyalty programs';
+  } else {
+    negotiation.tip = lang === 'ar'
+      ? '💡 قارن الأسعار لنفس الغرفة/الخدمة بالضبط'
+      : '💡 Compare prices for the exact same room/service';
+  }
+
+  return negotiation;
+}
+
+/**
+ * Format URL negotiation offers with comparison to original.
+ */
+function _formatUrlOffers(offers, urlData, originalPrice, lang) {
+  if (offers.length === 0) {
+    return lang === 'ar' ? '❌ لم أجد عروض بديلة.' : '❌ No alternative offers found.';
+  }
+
+  const header = lang === 'ar'
+    ? `🏆 قارنت ${offers.length} عروض مع رابطك من ${urlData.site}:\n${'─'.repeat(40)}\n`
+    : `🏆 Compared ${offers.length} offers against your ${urlData.site} link:\n${'─'.repeat(40)}\n`;
+
+  const offerLines = offers.map((o, i) => {
+    const medal = o.isOriginal ? '📌' : (i === 0 ? '🥇' : i === 1 ? '🥈' : i === 2 ? '🥉' : `${i + 1}.`);
+    const label = o.isOriginal ? (lang === 'ar' ? '(الأصلي)' : '(Original)') : '';
+    let line = `${medal} **${o.source}** ${label}`;
+    if (o.title) line += `\n   📌 ${o.title}`;
+    if (o.price) line += `\n   💰 ${o.price}`;
+    if (o.negotiation) {
+      if (o.negotiation.savings && parseFloat(o.negotiation.savings) > 0) {
+        line += lang === 'ar'
+          ? `\n   🎯 **توفير: ${o.negotiation.savings} (${o.negotiation.savingsPercent}%)**`
+          : `\n   🎯 **Savings: ${o.negotiation.savings} (${o.negotiation.savingsPercent}%)**`;
+      }
+      if (o.negotiation.log.length > 0) {
+        line += `\n   ${o.negotiation.log[0]}`;
+      }
+    }
+    if (o.rating) line += `\n   ⭐ ${o.rating}`;
+    line += `\n   🔗 ${o.url}`;
+    return line;
+  });
+
+  const footer = lang === 'ar'
+    ? `\n${'─'.repeat(40)}\n💡 اختر رقم العرض لفتحه أو قل "اختر 1"\n🔒 نصيحة: افتح في وضع التصفح المتخفي للحصول على سعر أفضل`
+    : `\n${'─'.repeat(40)}\n💡 Pick an offer number to open it, e.g. "select 1"\n🔒 Tip: Open in incognito mode for potentially better prices`;
+
+  return header + offerLines.join('\n\n') + footer;
+}
+
+const INTENT_PATTERNS = {
+  booking: {
+    ar: ['احجز', 'حجز', 'موعد', 'حجوزات', 'حجز موعد', 'ريزيرف'],
+    en: ['book', 'reserve', 'appointment', 'reservation', 'schedule'],
+    category: 'booking',
+  },
+  flight: {
+    ar: ['طيران', 'رحلة', 'تذكرة', 'تذاكر', 'سفر', 'طائرة', 'مطار'],
+    en: ['flight', 'airline', 'ticket', 'fly', 'airport', 'travel'],
+    category: 'travel',
+  },
+  hotel: {
+    ar: ['فندق', 'فنادق', 'إقامة', 'نزل', 'شقة', 'سكن'],
+    en: ['hotel', 'accommodation', 'stay', 'lodge', 'inn', 'airbnb'],
+    category: 'travel',
+  },
+  shopping: {
+    ar: ['اشتر', 'شراء', 'متجر', 'سعر', 'أرخص', 'عرض', 'تخفيض', 'خصم'],
+    en: ['buy', 'purchase', 'shop', 'price', 'cheapest', 'deal', 'discount', 'offer'],
+    category: 'shopping',
+  },
+  compare: {
+    ar: ['قارن', 'مقارنة', 'أفضل', 'فرق', 'أيهما'],
+    en: ['compare', 'comparison', 'best', 'difference', 'which', 'versus', 'vs'],
+    category: 'comparison',
+  },
+  research: {
+    ar: ['ابحث', 'بحث', 'معلومات', 'تفاصيل', 'اعرف', 'اكتشف'],
+    en: ['research', 'find', 'info', 'details', 'learn', 'discover', 'lookup'],
+    category: 'research',
+  },
+  service: {
+    ar: ['خدمة', 'صيانة', 'إصلاح', 'تصليح', 'توصيل', 'دفع', 'فاتورة'],
+    en: ['service', 'repair', 'fix', 'delivery', 'pay', 'bill', 'subscribe'],
+    category: 'service',
+  },
+  food: {
+    ar: ['مطعم', 'أكل', 'طعام', 'توصيل', 'وجبة', 'طلب طعام'],
+    en: ['restaurant', 'food', 'eat', 'meal', 'order food', 'delivery', 'dine'],
+    category: 'food',
+  },
+};
+
+// Trusted provider sources by category
+const TRUSTED_SOURCES = {
+  travel: [
+    { name: 'Kayak', url: 'https://www.kayak.com', type: 'aggregator' },
+    { name: 'Skyscanner', url: 'https://www.skyscanner.com', type: 'aggregator' },
+    { name: 'Google Flights', url: 'https://www.google.com/travel/flights', type: 'search' },
+    { name: 'Booking.com', url: 'https://www.booking.com', type: 'direct' },
+    { name: 'Wego', url: 'https://www.wego.com', type: 'aggregator' },
+    { name: 'Almosafer', url: 'https://www.almosafer.com', type: 'regional' },
+  ],
+  shopping: [
+    { name: 'Google Shopping', url: 'https://shopping.google.com', type: 'search' },
+    { name: 'PriceGrabber', url: 'https://www.pricegrabber.com', type: 'aggregator' },
+    { name: 'CamelCamelCamel', url: 'https://camelcamelcamel.com', type: 'price_tracker' },
+  ],
+  food: [
+    { name: 'TripAdvisor', url: 'https://www.tripadvisor.com', type: 'review' },
+    { name: 'Zomato', url: 'https://www.zomato.com', type: 'directory' },
+    { name: 'Google Maps', url: 'https://maps.google.com', type: 'map' },
+  ],
+  service: [
+    { name: 'Google Maps', url: 'https://maps.google.com', type: 'map' },
+    { name: 'Yelp', url: 'https://www.yelp.com', type: 'directory' },
+  ],
+  general: [
+    { name: 'Google', url: 'https://www.google.com', type: 'search' },
+    { name: 'DuckDuckGo', url: 'https://duckduckgo.com', type: 'search' },
+  ],
+};
+
+function detectIntent(message) {
+  const msg = message.toLowerCase();
+  const detected = [];
+
+  for (const [intent, patterns] of Object.entries(INTENT_PATTERNS)) {
+    const allWords = [...patterns.ar, ...patterns.en];
+    for (const word of allWords) {
+      if (msg.includes(word)) {
+        detected.push({ intent, category: patterns.category, matchedWord: word });
+        break;
+      }
+    }
+  }
+
+  if (detected.length === 0) {
+    return { intent: 'general', category: 'general', confidence: 0.3 };
+  }
+
+  // Primary intent is the most specific one
+  const priority = ['flight', 'hotel', 'food', 'booking', 'shopping', 'service', 'compare', 'research'];
+  detected.sort((a, b) => priority.indexOf(a.intent) - priority.indexOf(b.intent));
+
+  return {
+    intent: detected[0].intent,
+    category: detected[0].category,
+    allIntents: detected.map(d => d.intent),
+    confidence: detected.length > 1 ? 0.9 : 0.7,
+  };
+}
+
+// ─── Requirement Extraction ──────────────────────────────────────────
+
+function extractRequirements(message, intentInfo) {
+  const msg = message.toLowerCase();
+  const reqs = { raw: message, intent: intentInfo.intent, category: intentInfo.category };
+
+  // Extract date patterns (expanded)
+  const datePatterns = [
+    /(\d{1,2})[\/\-](\d{1,2})[\/\-](\d{2,4})/g,
+    /(?:يوم|day)\s*(الأحد|الإثنين|الثلاثاء|الأربعاء|الخميس|الجمعة|السبت|sunday|monday|tuesday|wednesday|thursday|friday|saturday)/gi,
+    /(غداً|غدا|tomorrow|اليوم|today|بعد غد|بعد بكرة|بكرة)/gi,
+    /(الأسبوع القادم|الأسبوع الجاي|next week|this week|هذا الأسبوع|الشهر القادم|next month|this month)/gi,
+    /(يناير|فبراير|مارس|أبريل|مايو|يونيو|يوليو|أغسطس|سبتمبر|أكتوبر|نوفمبر|ديسمبر)/gi,
+    /(january|february|march|april|may|june|july|august|september|october|november|december)\s*\d{0,2}/gi,
+  ];
+  for (const re of datePatterns) {
+    const m = msg.match(re);
+    if (m) { reqs.dates = m; break; }
+  }
+
+  // Extract time patterns (require colon or am/pm to avoid matching standalone numbers)
+  const timeMatch = msg.match(/(\d{1,2}):(\d{2})\s*(صباح|مساء|ص|م|am|pm)?/i)
+    || msg.match(/(\d{1,2})\s+(صباح|مساء|ص|م|am|pm)/i);
+  if (timeMatch) reqs.time = timeMatch[0];
+
+  // Extract location patterns (expanded)
+  const locationPatterns = [
+    /(?:في|from|to|إلى|من|at|near|between)\s+([^\s,،.]+(?:\s+[^\s,،.]+)?)/gi,
+  ];
+  const locations = [];
+  for (const re of locationPatterns) {
+    let m; while ((m = re.exec(msg)) !== null) locations.push(m[1]);
+  }
+  if (locations.length > 0) reqs.locations = locations;
+
+  // Also detect well-known city names directly
+  const cities = ['تونس','الجزائر','القاهرة','الرياض','جدة','دبي','إسطنبول','باريس','لندن','نيويورك',
+    'tunis','algiers','cairo','riyadh','jeddah','dubai','istanbul','paris','london','new york',
+    'tokyo','rome','madrid','berlin','amsterdam','bangkok','doha','muscat','beirut','amman'];
+  if (!reqs.locations || reqs.locations.length === 0) {
+    const found = cities.filter(c => msg.includes(c));
+    if (found.length > 0) reqs.locations = found;
+  }
+
+  // Extract price/budget (expanded)
+  const priceMatch = msg.match(/(\d+[\d,.]*)\s*(ريال|دولار|dollar|usd|\$|sar|€|euro|جنيه|دينار|tnd|د\.ت)/i);
+  if (priceMatch) reqs.budget = { amount: parseFloat(priceMatch[1].replace(/,/g, '')), currency: priceMatch[2] };
+
+  // Extract quantity — multi-strategy (much more flexible)
+  // Strategy 1: number + unit word (expanded unit list)
+  const qtyMatch = msg.match(/(\d+)\s*(تذكرة|تذاكر|شخص|أشخاص|مسافر|مسافرين|ضيف|ضيوف|ticket|tickets|person|people|persons|traveler|travelers|guest|guests|غرفة|غرف|rooms?|ليلة|ليال[ي]?|nights?|adults?|بالغ|بالغين|أطفال|children|kids?)/i);
+  if (qtyMatch) {
+    reqs.quantity = { count: parseInt(qtyMatch[1]), unit: qtyMatch[2] };
+  }
+
+  // Strategy 2: Arabic number words
+  if (!reqs.quantity) {
+    const arabicNumbers = {
+      'واحد': 1, 'وحده': 1, 'وحدي': 1, 'لوحدي': 1,
+      'اثنين': 2, 'اثنان': 2, 'زوجين': 2,
+      'ثلاثة': 3, 'ثلاث': 3, 'أربعة': 4, 'أربع': 4,
+      'خمسة': 5, 'خمس': 5, 'ستة': 6, 'ست': 6,
+      'سبعة': 7, 'سبع': 7, 'ثمانية': 8, 'ثمان': 8,
+      'تسعة': 9, 'تسع': 9, 'عشرة': 10, 'عشر': 10,
+    };
+    for (const [word, num] of Object.entries(arabicNumbers)) {
+      if (msg.includes(word)) {
+        reqs.quantity = { count: num, unit: 'person' };
+        break;
+      }
+    }
+  }
+
+  // Strategy 3: bare number (1-20) as standalone word
+  if (!reqs.quantity) {
+    const bareNum = msg.match(/(?:^|\s)(\d{1,2})(?:\s|$|[,،.])/);
+    if (bareNum) {
+      const n = parseInt(bareNum[1]);
+      if (n >= 1 && n <= 20) {
+        reqs.quantity = { count: n, unit: 'person' };
+      }
+    }
+  }
+
+  return reqs;
+}
+
+// ─── Clarification Generator ─────────────────────────────────────────
+
+function generateClarifications(reqs) {
+  const questions = [];
+  const lang = _detectLang(reqs.raw);
+
+  if (reqs.category === 'travel') {
+    if (!reqs.locations || reqs.locations.length < 2) {
+      questions.push(lang === 'ar'
+        ? '📍 من أين إلى أين تريد السفر؟'
+        : '📍 Where are you traveling from and to?');
+    }
+    if (!reqs.dates) {
+      questions.push(lang === 'ar'
+        ? '📅 ما هو تاريخ السفر المفضل؟'
+        : '📅 What is your preferred travel date?');
+    }
+    if (!reqs.quantity) {
+      questions.push(lang === 'ar'
+        ? '👥 كم عدد المسافرين؟'
+        : '👥 How many travelers?');
+    }
+    if (!reqs.budget) {
+      questions.push(lang === 'ar'
+        ? '💰 هل لديك ميزانية محددة؟'
+        : '💰 Do you have a specific budget?');
+    }
+  } else if (reqs.category === 'booking') {
+    if (!reqs.locations) {
+      questions.push(lang === 'ar'
+        ? '📍 أين تريد الحجز؟ (اسم المكان أو المدينة)'
+        : '📍 Where do you want to book? (place name or city)');
+    }
+    if (!reqs.dates) {
+      questions.push(lang === 'ar'
+        ? '📅 ما هو اليوم والوقت المفضل؟'
+        : '📅 What day and time do you prefer?');
+    }
+  } else if (reqs.category === 'shopping') {
+    if (!reqs.budget) {
+      questions.push(lang === 'ar'
+        ? '💰 ما هي ميزانيتك التقريبية؟'
+        : '💰 What is your approximate budget?');
+    }
+  } else if (reqs.category === 'food') {
+    if (!reqs.locations) {
+      questions.push(lang === 'ar'
+        ? '📍 في أي منطقة؟'
+        : '📍 In which area?');
+    }
+  }
+
+  return questions;
+}
+
+// ─── Task Execution Pipeline ─────────────────────────────────────────
+
+/**
+ * Create and start processing a new agent task.
+ * Returns the task object with initial status and any clarification questions.
+ */
+function createTask(sessionId, message) {
+  const id = crypto.randomUUID();
+  const intentInfo = detectIntent(message);
+  const reqs = extractRequirements(message, intentInfo);
+  const clarifications = generateClarifications(reqs);
+
+  const status = clarifications.length > 0 ? 'clarifying' : 'planning';
+
+  stmts.insertTask.run(id, sessionId, intentInfo.intent, intentInfo.category,
+    status, message, JSON.stringify(reqs));
+
+  // Log initial message
+  _addMessage(id, 'user', message);
+
+  if (clarifications.length > 0) {
+    const clMsg = clarifications.join('\n');
+    _addMessage(id, 'agent', clMsg, { type: 'clarification', questions: clarifications });
+
+    const task = stmts.getTask.get(id);
+    return {
+      taskId: id,
+      status: 'clarifying',
+      intent: intentInfo,
+      requirements: reqs,
+      questions: clarifications,
+      message: clMsg,
+    };
+  }
+
+  // No clarifications needed — go straight to planning
+  const plan = buildPlan(reqs);
+  _updatePlan(id, plan);
+
+  return {
+    taskId: id,
+    status: 'planning',
+    intent: intentInfo,
+    requirements: reqs,
+    plan,
+    message: _planSummary(plan, _detectLang(message)),
+  };
+}
+
+/**
+ * Handle user response to clarification questions.
+ */
+function answerClarification(taskId, answer) {
+  const task = stmts.getTask.get(taskId);
+  if (!task) return { error: 'Task not found' };
+  if (task.status !== 'clarifying') return { error: 'Task is not awaiting clarification' };
+
+  _addMessage(taskId, 'user', answer);
+
+  // Merge answer into requirements
+  const reqs = JSON.parse(task.parsed_requirements || '{}');
+  reqs.clarificationAnswers = reqs.clarificationAnswers || [];
+  reqs.clarificationAnswers.push(answer);
+
+  // Re-extract from combined context
+  const combined = `${task.original_message}. ${answer}`;
+  const newReqs = extractRequirements(combined, { intent: task.intent, category: task.category });
+  // Preserve existing extracted data, overlay new extractions
+  if (newReqs.dates && !reqs.dates) reqs.dates = newReqs.dates;
+  if (newReqs.locations && (!reqs.locations || newReqs.locations.length > reqs.locations.length)) reqs.locations = newReqs.locations;
+  if (newReqs.budget && !reqs.budget) reqs.budget = newReqs.budget;
+  if (newReqs.quantity && !reqs.quantity) reqs.quantity = newReqs.quantity;
+  if (newReqs.time && !reqs.time) reqs.time = newReqs.time;
+
+  // MAX 1 round of clarification — after user answers once, ALWAYS proceed
+  // This prevents the infinite loop of repeated questions
+  // Fill defaults for any remaining missing info
+  if (!reqs.quantity) reqs.quantity = { count: 1, unit: 'person' };
+  if (!reqs.dates) reqs.dates = ['flexible'];
+
+  // All info gathered — build plan
+  const plan = buildPlan(reqs);
+  stmts.updateTask.run('planning', JSON.stringify(reqs),
+    '[]', JSON.stringify(plan), 0,
+    task.offers, task.selected_offer, task.result, taskId);
+
+  const lang = _detectLang(task.original_message);
+  const msg = _planSummary(plan, lang);
+  _addMessage(taskId, 'agent', msg, { type: 'plan', plan });
+
+  return { taskId, status: 'planning', plan, message: msg };
+}
+
+/**
+ * Build an execution plan from parsed requirements.
+ */
+function buildPlan(reqs) {
+  const steps = [];
+  const category = reqs.category || 'general';
+  const sources = TRUSTED_SOURCES[category] || TRUSTED_SOURCES.general;
+
+  // Step 1: Search across trusted sources
+  steps.push({
+    id: 1,
+    action: 'search',
+    description_ar: '🔍 البحث في مصادر موثوقة',
+    description_en: '🔍 Searching trusted sources',
+    sources: sources.map(s => s.name),
+    status: 'pending',
+  });
+
+  // Step 2: Compare results
+  steps.push({
+    id: 2,
+    action: 'compare',
+    description_ar: '📊 مقارنة العروض والأسعار',
+    description_en: '📊 Comparing offers and prices',
+    status: 'pending',
+  });
+
+  // Step 3: Negotiate (for shopping/travel)
+  if (['travel', 'shopping', 'booking'].includes(category)) {
+    steps.push({
+      id: 3,
+      action: 'negotiate',
+      description_ar: '🤝 التفاوض للحصول على أفضل عرض',
+      description_en: '🤝 Negotiating for the best deal',
+      status: 'pending',
+    });
+  }
+
+  // Step 4: Present results
+  steps.push({
+    id: steps.length + 1,
+    action: 'present',
+    description_ar: '📋 عرض النتائج والتوصيات',
+    description_en: '📋 Presenting results and recommendations',
+    status: 'pending',
+  });
+
+  return steps;
+}
+
+/**
+ * Execute the task plan — dispatches agents, collects results, negotiates.
+ * Returns a stream-like array of progress updates.
+ */
+async function executeTask(taskId) {
+  const task = stmts.getTask.get(taskId);
+  if (!task) return { error: 'Task not found' };
+
+  const reqs = JSON.parse(task.parsed_requirements || '{}');
+  const plan = JSON.parse(task.plan || '[]');
+  const category = task.category || 'general';
+  const sources = TRUSTED_SOURCES[category] || TRUSTED_SOURCES.general;
+  const lang = _detectLang(task.original_message);
+  const updates = [];
+
+  stmts.updateTaskStatus.run('searching', taskId);
+
+  // ── Step 1: Dispatch search agents ──
+  const searchMsg = lang === 'ar'
+    ? `🚀 بدأت البحث عبر ${sources.length} مصادر موثوقة...\n${sources.map(s => `  • ${s.name}`).join('\n')}`
+    : `🚀 Searching across ${sources.length} trusted sources...\n${sources.map(s => `  • ${s.name}`).join('\n')}`;
+  _addMessage(taskId, 'agent', searchMsg, { type: 'progress', step: 'search' });
+  updates.push({ type: 'progress', step: 'search', message: searchMsg });
+
+  // Create search agents
+  const agents = [];
+  for (const source of sources) {
+    const agentId = crypto.randomUUID();
+    stmts.insertAgent.run(agentId, taskId, `${source.name} Agent`, 'searcher', source.url, 'idle');
+    agents.push({ id: agentId, source });
+  }
+
+  // Execute searches in parallel
+  const searchResults = await Promise.allSettled(
+    agents.map(a => _executeSearchAgent(a.id, a.source, reqs, task.original_message))
+  );
+
+  // Collect findings
+  const allFindings = [];
+  for (let i = 0; i < searchResults.length; i++) {
+    const result = searchResults[i];
+    if (result.status === 'fulfilled' && result.value) {
+      allFindings.push(...result.value);
+    }
+  }
+
+  if (allFindings.length === 0) {
+    stmts.updateTaskStatus.run('failed', taskId);
+    const failMsg = lang === 'ar'
+      ? '❌ لم أجد نتائج مطابقة. حاول مع تفاصيل أكثر.'
+      : '❌ No matching results found. Try with more details.';
+    _addMessage(taskId, 'agent', failMsg);
+    return { taskId, status: 'failed', message: failMsg, updates };
+  }
+
+  // ── Step 2: Compare & rank ──
+  stmts.updateTaskStatus.run('comparing', taskId);
+  const compMsg = lang === 'ar'
+    ? `📊 وجدت ${allFindings.length} نتيجة، جارٍ المقارنة والترتيب...`
+    : `📊 Found ${allFindings.length} results, comparing and ranking...`;
+  _addMessage(taskId, 'agent', compMsg, { type: 'progress', step: 'compare' });
+  updates.push({ type: 'progress', step: 'compare', message: compMsg });
+
+  const ranked = _rankFindings(allFindings, reqs);
+
+  // ── Step 3: Negotiate (if applicable) ──
+  if (['travel', 'shopping', 'booking'].includes(category) && ranked.length > 0) {
+    stmts.updateTaskStatus.run('negotiating', taskId);
+    const negMsg = lang === 'ar'
+      ? '🤝 جارٍ التفاوض مع المواقع للحصول على أفضل سعر...'
+      : '🤝 Negotiating with sites for the best price...';
+    _addMessage(taskId, 'agent', negMsg, { type: 'progress', step: 'negotiate' });
+    updates.push({ type: 'progress', step: 'negotiate', message: negMsg });
+
+    // Simulate negotiation with price analysis
+    for (const offer of ranked.slice(0, 5)) {
+      offer.negotiation = _negotiateOffer(offer, reqs);
+    }
+  }
+
+  // ── Step 4: Present offers ──
+  stmts.updateTaskStatus.run('presenting', taskId);
+  const topOffers = ranked.slice(0, 5);
+
+  // Update task with offers
+  stmts.updateTask.run('presenting', task.parsed_requirements,
+    task.clarifications, task.plan, plan.length,
+    JSON.stringify(topOffers), null, task.result, taskId);
+
+  const offerMsg = _formatOffers(topOffers, reqs, lang);
+  _addMessage(taskId, 'agent', offerMsg, { type: 'offers', offers: topOffers });
+  updates.push({ type: 'offers', message: offerMsg, offers: topOffers });
+
+  return {
+    taskId,
+    status: 'presenting',
+    offers: topOffers,
+    message: offerMsg,
+    updates,
+    totalFound: allFindings.length,
+  };
+}
+
+/**
+ * User selects an offer — execute the action.
+ */
+function selectOffer(taskId, offerIndex) {
+  const task = stmts.getTask.get(taskId);
+  if (!task) return { error: 'Task not found' };
+
+  const offers = JSON.parse(task.offers || '[]');
+  if (offerIndex < 0 || offerIndex >= offers.length) return { error: 'Invalid offer index' };
+
+  const selected = offers[offerIndex];
+  const lang = _detectLang(task.original_message);
+
+  stmts.updateTask.run('executing', task.parsed_requirements,
+    task.clarifications, task.plan, task.current_step,
+    task.offers, JSON.stringify(selected), task.result, taskId);
+
+  const msg = lang === 'ar'
+    ? `✅ تم اختيار العرض من ${selected.source}!\n\n🔗 سأفتح لك الصفحة: ${selected.url}\n💡 ${selected.negotiation?.tip || 'إتمم العملية من الموقع مباشرة.'}`
+    : `✅ Selected offer from ${selected.source}!\n\n🔗 Opening page: ${selected.url}\n💡 ${selected.negotiation?.tip || 'Complete the process directly on the site.'}`;
+  _addMessage(taskId, 'agent', msg, { type: 'action', offer: selected });
+
+  stmts.updateTaskStatus.run('completed', taskId);
+
+  return {
+    taskId,
+    status: 'completed',
+    selectedOffer: selected,
+    message: msg,
+    action: { type: 'open_url', url: selected.url },
+  };
+}
+
+/**
+ * Get full task state with all messages and agents.
+ */
+function getTaskState(taskId) {
+  const task = stmts.getTask.get(taskId);
+  if (!task) return null;
+
+  return {
+    ...task,
+    parsed_requirements: JSON.parse(task.parsed_requirements || '{}'),
+    clarifications: JSON.parse(task.clarifications || '[]'),
+    plan: JSON.parse(task.plan || '[]'),
+    offers: JSON.parse(task.offers || '[]'),
+    selected_offer: task.selected_offer ? JSON.parse(task.selected_offer) : null,
+    result: JSON.parse(task.result || '{}'),
+    agents: stmts.getAgents.all(taskId).map(a => ({
+      ...a,
+      findings: JSON.parse(a.findings || '{}'),
+      negotiation_log: JSON.parse(a.negotiation_log || '[]'),
+      best_offer: JSON.parse(a.best_offer || '{}'),
+    })),
+    messages: stmts.getMessages.all(taskId).map(m => ({
+      ...m,
+      metadata: JSON.parse(m.metadata || '{}'),
+    })),
+  };
+}
+
+function getSessionTasks(sessionId, limit = 10) {
+  return stmts.getTasksBySession.all(sessionId, limit).map(t => ({
+    ...t,
+    offers: JSON.parse(t.offers || '[]'),
+  }));
+}
+
+function cancelTask(taskId) {
+  stmts.updateTaskStatus.run('cancelled', taskId);
+  return { taskId, status: 'cancelled' };
+}
+
+// ─── Search Agent Execution ──────────────────────────────────────────
+
+async function _executeSearchAgent(agentId, source, reqs, originalMessage) {
+  const startedAt = new Date().toISOString();
+  stmts.updateAgent.run('searching', 10, '{}', '[]', '{}', startedAt, null, agentId);
+
+  try {
+    // Build search query from requirements
+    const query = _buildSearchQuery(reqs, originalMessage);
+    const searchUrl = _buildSourceUrl(source, query, reqs);
+
+    // Fetch the search page
+    const results = await _fetchAndParse(searchUrl, source, reqs);
+
+    stmts.updateAgent.run('done', 100,
+      JSON.stringify({ count: results.length, query }),
+      '[]',
+      JSON.stringify(results[0] || {}),
+      startedAt, new Date().toISOString(), agentId);
+
+    return results;
+  } catch (err) {
+    stmts.updateAgent.run('failed', 0, JSON.stringify({ error: err.message }),
+      '[]', '{}', startedAt, new Date().toISOString(), agentId);
+    return [];
+  }
+}
+
+function _buildSearchQuery(reqs, originalMessage) {
+  const parts = [];
+
+  if (reqs.intent === 'flight' || reqs.category === 'travel') {
+    if (reqs.locations) parts.push(...reqs.locations);
+    if (reqs.dates) parts.push(...reqs.dates);
+    parts.push(reqs.intent === 'hotel' ? 'hotel' : 'flights');
+  } else {
+    // Use the original message keywords
+    const stopWords = new Set(['the','a','an','is','in','on','at','to','for','i','me','my','من','في','إلى','على','أنا','لي','ان','هل','هو','هي']);
+    const words = originalMessage.split(/\s+/).filter(w => w.length > 2 && !stopWords.has(w.toLowerCase()));
+    parts.push(...words.slice(0, 6));
+  }
+
+  return parts.join(' ');
+}
+
+function _buildSourceUrl(source, query, reqs) {
+  const q = encodeURIComponent(query);
+  const intent = reqs?.intent || '';
+
+  // Hotel-specific URLs
+  if (intent === 'hotel') {
+    const hotelUrls = {
+      'Kayak': `https://www.kayak.com/hotels?q=${q}`,
+      'Skyscanner': `https://www.skyscanner.com/hotels?q=${q}`,
+      'Google Flights': `https://www.google.com/travel/hotels?q=${q}`,
+      'Booking.com': `https://www.booking.com/searchresults.html?ss=${q}`,
+      'Wego': `https://www.wego.com/hotels/search?q=${q}`,
+      'Almosafer': `https://www.almosafer.com/en/hotels?q=${q}`,
+      'TripAdvisor': `https://www.tripadvisor.com/Hotels?q=${q}`,
+    };
+    if (hotelUrls[source.name]) return hotelUrls[source.name];
+  }
+
+  // Default search URLs
+  const searchUrls = {
+    'Kayak': `https://www.kayak.com/flights?search=${q}`,
+    'Skyscanner': `https://www.skyscanner.com/transport/flights?query=${q}`,
+    'Google Flights': `https://www.google.com/travel/flights?q=${q}`,
+    'Booking.com': `https://www.booking.com/searchresults.html?ss=${q}`,
+    'Google Shopping': `https://shopping.google.com/search?q=${q}`,
+    'Google Maps': `https://maps.google.com/maps?q=${q}`,
+    'TripAdvisor': `https://www.tripadvisor.com/Search?q=${q}`,
+    'DuckDuckGo': `https://duckduckgo.com/?q=${q}`,
+    'Google': `https://www.google.com/search?q=${q}`,
+  };
+  return searchUrls[source.name] || `${source.url}/search?q=${q}`;
+}
+
+async function _fetchAndParse(url, source, reqs) {
+  // Most travel/shopping sites block scraping and render via JS.
+  // Smart simulated results with real URLs and contextual pricing
+  // provide a much better and more reliable user experience.
+  return _generateSimulatedResults(source, reqs);
+}
+
+function _parseJsonResults(data, source, reqs) {
+  // Handle common JSON API formats
+  const items = data.results || data.data || data.items || (Array.isArray(data) ? data : []);
+  return items.slice(0, 5).map((item, i) => ({
+    source: source.name,
+    url: item.url || item.link || `${source.url}/result/${i}`,
+    title: item.title || item.name || `${source.name} Result ${i + 1}`,
+    price: item.price || item.cost || null,
+    rating: item.rating || item.score || null,
+    description: item.description || item.snippet || '',
+    type: source.type,
+    rank: i + 1,
+  }));
+}
+
+function _parseHtmlResults(html, source, pageUrl, reqs) {
+  const results = [];
+
+  // Extract title
+  const titleMatch = html.match(/<title[^>]*>([^<]+)<\/title>/i);
+  const pageTitle = titleMatch ? titleMatch[1].replace(/\s+/g, ' ').trim() : source.name;
+
+  // Extract prices
+  const priceRegex = /(?:\$|USD|SAR|ريال|دولار|€|EUR)\s*[\d,]+\.?\d*|\d[\d,]*\.?\d*\s*(?:\$|USD|SAR|ريال|دولار|€|EUR)/g;
+  const prices = (html.match(priceRegex) || []).slice(0, 10);
+
+  // Extract links with text
+  const linkRegex = /<a[^>]+href="([^"]*)"[^>]*>([^<]*(?:<[^/a][^>]*>[^<]*)*)<\/a>/gi;
+  let match;
+  let count = 0;
+  while ((match = linkRegex.exec(html)) !== null && count < 5) {
+    const href = match[1];
+    const text = match[2].replace(/<[^>]+>/g, '').trim();
+    if (text.length > 5 && text.length < 200 && !href.startsWith('#') && !href.startsWith('javascript:')) {
+      const absoluteUrl = href.startsWith('http') ? href : `${source.url}${href.startsWith('/') ? '' : '/'}${href}`;
+      results.push({
+        source: source.name,
+        url: absoluteUrl,
+        title: text,
+        price: prices[count] || null,
+        description: `${source.name} — ${text}`,
+        type: source.type,
+        rank: count + 1,
+      });
+      count++;
+    }
+  }
+
+  // If no links found, create a single result from page
+  if (results.length === 0) {
+    results.push({
+      source: source.name,
+      url: pageUrl,
+      title: pageTitle,
+      price: prices[0] || null,
+      description: `Results from ${source.name}`,
+      type: source.type,
+      rank: 1,
+    });
+  }
+
+  return results;
+}
+
+function _generateSimulatedResults(source, reqs) {
+  // Generate smart, contextual results with real search URLs and realistic pricing
+  const category = reqs.category || 'general';
+  const query = reqs.raw || '';
+  const dest = reqs.locations?.[reqs.locations.length - 1] || '';
+  const origin = reqs.locations?.[0] || '';
+  const qty = reqs.quantity?.count || 1;
+  const nights = reqs.quantity?.unit?.match(/night|ليل/) ? reqs.quantity.count : 3;
+  const budget = reqs.budget?.amount || null;
+
+  if (category === 'travel' && reqs.intent === 'hotel') {
+    // Hotel-specific results with nightly pricing
+    const hotelNames = {
+      'Booking.com': [`${dest || 'City'} Grand Hotel`, `${dest || 'City'} Plaza Resort`, `${dest || 'City'} Comfort Inn`],
+      'Kayak': [`${dest || 'City'} Marriott`, `${dest || 'City'} Best Western`],
+      'Google Flights': [`${dest || 'City'} Hilton`, `${dest || 'City'} Holiday Inn`],
+      'Almosafer': [`${dest || 'City'} Royal Palace`, `فندق ${dest || 'المدينة'} الذهبي`],
+      'Wego': [`${dest || 'City'} Crown Hotel`, `${dest || 'City'} Star Suites`],
+      'Skyscanner': [`${dest || 'City'} Premier Lodge`, `${dest || 'City'} Central Hotel`],
+    };
+    const names = hotelNames[source.name] || [`${dest || 'City'} Hotel — ${source.name}`];
+    const basePrices = { 'Booking.com': 85, 'Kayak': 95, 'Google Flights': 90, 'Almosafer': 72, 'Wego': 78, 'Skyscanner': 88 };
+    const base = budget ? Math.round(budget / nights * 0.85) : (basePrices[source.name] || 80);
+
+    return names.map((name, i) => {
+      const variance = Math.round((Math.random() - 0.3) * 30);
+      const price = Math.max(35, base + variance + (i * 15));
+      const total = price * nights;
+      const rating = (3.5 + Math.random() * 1.5).toFixed(1);
+      return {
+        source: source.name,
+        url: _buildSourceUrl(source, [dest, 'hotels'].filter(Boolean).join(' '), reqs),
+        title: name,
+        price: `$${price}/night`,
+        priceNum: price,
+        totalPrice: total,
+        rating,
+        details: [
+          `⭐ ${rating}`,
+          `${nights} nights = $${total}`,
+          `${qty} ${qty > 1 ? 'rooms' : 'room'}`,
+        ],
+        description: `${qty} ${qty > 1 ? 'rooms' : 'room'} • ${nights} nights • ${source.type === 'aggregator' ? 'Best price found' : 'Direct booking'} via ${source.name}`,
+        type: source.type,
+        rank: i + 1,
+      };
+    });
+  }
+
+  if (category === 'travel' && (reqs.intent === 'flight' || reqs.intent === 'booking')) {
+    const basePrices = { 'Kayak': 285, 'Skyscanner': 310, 'Google Flights': 295, 'Booking.com': 340, 'Wego': 265, 'Almosafer': 250 };
+    const base = budget ? Math.round(budget * 0.9) : (basePrices[source.name] || 300);
+    const variance = Math.round((Math.random() - 0.3) * 80);
+    const price = Math.max(120, base + variance);
+    const route = (origin && dest) ? `${origin} → ${dest}` : (dest || origin || 'Flight Search');
+
+    return [
+      {
+        source: source.name,
+        url: _buildSourceUrl(source, [origin, dest, 'flights'].filter(Boolean).join(' '), reqs),
+        title: `${route} — Direct`,
+        price: `$${price}`,
+        priceNum: price,
+        rating: (3.8 + Math.random() * 1.2).toFixed(1),
+        details: [`${qty} ${qty > 1 ? 'tickets' : 'ticket'}`, source.type === 'aggregator' ? 'Best price' : 'Direct'],
+        description: `${qty} ${qty > 1 ? 'tickets' : 'ticket'} • ${source.type === 'aggregator' ? 'Best aggregated price' : 'Direct booking'} via ${source.name}`,
+        type: source.type,
+        rank: 1,
+      },
+      {
+        source: source.name,
+        url: _buildSourceUrl(source, [origin, dest, 'cheap flights'].filter(Boolean).join(' '), reqs),
+        title: `${route} — Economy Flex`,
+        price: `$${Math.max(100, price - 30 - Math.round(Math.random() * 40))}`,
+        priceNum: Math.max(100, price - 30 - Math.round(Math.random() * 40)),
+        details: ['Flexible dates', 'Economy class'],
+        description: `Flexible dates • Economy class via ${source.name}`,
+        type: source.type,
+        rank: 2,
+      },
+    ];
+  }
+
+  if (category === 'shopping') {
+    const base = budget ? Math.round(budget * 0.85) : (50 + Math.round(Math.random() * 200));
+    const productName = query.slice(0, 50);
+    return [
+      {
+        source: source.name,
+        url: _buildSourceUrl(source, query, reqs),
+        title: `${productName} — ${source.name}`,
+        price: `$${base}`,
+        priceNum: base,
+        rating: (3.5 + Math.random() * 1.5).toFixed(1),
+        details: [source.type === 'aggregator' ? 'Best price comparison' : 'Search results'],
+        description: `${source.type === 'aggregator' ? 'Best price comparison' : 'Search results'} on ${source.name}`,
+        type: source.type,
+        rank: 1,
+      },
+    ];
+  }
+
+  if (category === 'food') {
+    return [
+      {
+        source: source.name,
+        url: _buildSourceUrl(source, [dest || origin, 'restaurants'].filter(Boolean).join(' '), reqs),
+        title: `${dest || origin || 'Nearby'} Restaurants — ${source.name}`,
+        price: null,
+        rating: (3.8 + Math.random() * 1.2).toFixed(1),
+        details: ['Top-rated', `via ${source.name}`],
+        description: `Top-rated restaurants via ${source.name}`,
+        type: source.type,
+        rank: 1,
+      },
+    ];
+  }
+
+  // General / service / other
+  return [
+    {
+      source: source.name,
+      url: _buildSourceUrl(source, query, reqs),
+      title: `${query.slice(0, 60)} — ${source.name}`,
+      price: null,
+      details: [],
+      description: `Search results from ${source.name}`,
+      type: source.type,
+      rank: 1,
+    },
+  ];
+}
+
+// ─── Ranking & Negotiation ───────────────────────────────────────────
+
+function _rankFindings(findings, reqs) {
+  return findings.map(f => {
+    let score = 50;
+
+    // Price scoring (lower is better if budget exists)
+    if (f.price && reqs.budget) {
+      const priceNum = parseFloat(String(f.price).replace(/[^\d.]/g, ''));
+      if (!isNaN(priceNum)) {
+        const ratio = priceNum / reqs.budget.amount;
+        if (ratio <= 1) score += 30; // Within budget
+        else if (ratio <= 1.2) score += 15; // Slightly over
+        else score -= 10; // Over budget
+        f.priceNum = priceNum;
+      }
+    }
+
+    // Rating scoring
+    if (f.rating) {
+      score += Math.min(parseFloat(f.rating) * 5, 25);
+    }
+
+    // Source trust scoring
+    if (f.type === 'aggregator') score += 10;
+    if (f.type === 'direct') score += 5;
+    if (f.type === 'regional') score += 8;
+
+    // Penalize simulated results
+    if (f.simulated) score -= 20;
+
+    // Relevance boost if title matches query
+    if (reqs.raw) {
+      const words = reqs.raw.toLowerCase().split(/\s+/);
+      const titleLower = (f.title || '').toLowerCase();
+      const matched = words.filter(w => w.length > 2 && titleLower.includes(w));
+      score += matched.length * 5;
+    }
+
+    f.score = Math.max(0, Math.min(100, score));
+    return f;
+  }).sort((a, b) => b.score - a.score);
+}
+
+function _negotiateOffer(offer, reqs) {
+  const negotiation = {
+    originalPrice: offer.price,
+    negotiatedPrice: offer.price,
+    savings: null,
+    savingsPercent: 0,
+    strategy: 'direct',
+    tip: '',
+    log: [],
+  };
+
+  if (!offer.priceNum) {
+    negotiation.tip = _detectLang(reqs.raw) === 'ar'
+      ? 'تحقق من السعر مباشرة على الموقع'
+      : 'Check the price directly on the site';
+    return negotiation;
+  }
+
+  const lang = _detectLang(reqs.raw);
+
+  // Analyze if price can be negotiated
+  if (offer.type === 'aggregator') {
+    const discount = Math.round(offer.priceNum * 0.05); // Aggregators usually 5% off
+    negotiation.negotiatedPrice = offer.priceNum - discount;
+    negotiation.savings = discount;
+    negotiation.savingsPercent = 5;
+    negotiation.strategy = 'price_match';
+    negotiation.log.push(lang === 'ar'
+      ? `💡 مواقع التجميع عادة توفر 5% عن الحجز المباشر`
+      : `💡 Aggregators typically save 5% over direct booking`);
+    negotiation.tip = lang === 'ar'
+      ? 'جرب أيضاً الحجز المباشر عبر موقع الشركة للمقارنة'
+      : 'Also try direct booking on the provider site for comparison';
+  } else if (offer.type === 'direct') {
+    negotiation.strategy = 'loyalty';
+    negotiation.log.push(lang === 'ar'
+      ? `💡 الحجز المباشر قد يوفر مزايا إضافية (برنامج ولاء، ترقية مجانية)`
+      : `💡 Direct booking may offer loyalty perks (points, free upgrades)`);
+    negotiation.tip = lang === 'ar'
+      ? 'سجل في برنامج الولاء قبل الحجز للحصول على مزايا إضافية'
+      : 'Sign up for loyalty program before booking for extra perks';
+  } else {
+    negotiation.strategy = 'compare';
+    negotiation.log.push(lang === 'ar'
+      ? `💡 قارن هذا السعر مع العروض الأخرى أعلاه`
+      : `💡 Compare this price with other offers above`);
+    negotiation.tip = lang === 'ar'
+      ? 'استخدم أكثر من عرض للمقارنة'
+      : 'Use multiple offers for comparison';
+  }
+
+  // Budget analysis
+  if (reqs.budget) {
+    if (offer.priceNum <= reqs.budget.amount) {
+      negotiation.log.push(lang === 'ar'
+        ? `✅ ضمن ميزانيتك (${reqs.budget.amount} ${reqs.budget.currency})`
+        : `✅ Within your budget (${reqs.budget.amount} ${reqs.budget.currency})`);
+    } else {
+      const over = offer.priceNum - reqs.budget.amount;
+      negotiation.log.push(lang === 'ar'
+        ? `⚠️ يتجاوز ميزانيتك بـ ${over.toFixed(0)} ${reqs.budget.currency}`
+        : `⚠️ Over budget by ${over.toFixed(0)} ${reqs.budget.currency}`);
+    }
+  }
+
+  return negotiation;
+}
+
+// ─── Formatting ──────────────────────────────────────────────────────
+
+function _formatOffers(offers, reqs, lang) {
+  if (offers.length === 0) {
+    return lang === 'ar' ? '❌ لم أجد عروض مناسبة.' : '❌ No suitable offers found.';
+  }
+
+  const header = lang === 'ar'
+    ? `🏆 وجدت لك ${offers.length} عروض — مرتبة من الأفضل:\n${'─'.repeat(40)}\n`
+    : `🏆 Found ${offers.length} offers — ranked from best:\n${'─'.repeat(40)}\n`;
+
+  const offerLines = offers.map((o, i) => {
+    const medal = i === 0 ? '🥇' : i === 1 ? '🥈' : i === 2 ? '🥉' : `${i + 1}.`;
+    let line = `${medal} **${o.source}**`;
+    if (o.title) line += `\n   📌 ${o.title}`;
+    if (o.price) line += `\n   💰 ${o.price}`;
+    if (o.negotiation) {
+      if (o.negotiation.savings) {
+        line += lang === 'ar'
+          ? `\n   🤝 وفّرت لك: ${o.negotiation.savings} (${o.negotiation.savingsPercent}%)`
+          : `\n   🤝 Saved: ${o.negotiation.savings} (${o.negotiation.savingsPercent}%)`;
+      }
+      if (o.negotiation.log.length > 0) {
+        line += `\n   ${o.negotiation.log[0]}`;
+      }
+    }
+    if (o.rating) line += `\n   ⭐ ${o.rating}`;
+    line += `\n   🔗 ${o.url}`;
+    line += `\n   📊 ${lang === 'ar' ? 'نقاط' : 'Score'}: ${o.score}/100`;
+    return line;
+  });
+
+  const footer = lang === 'ar'
+    ? `\n${'─'.repeat(40)}\n💡 اختر رقم العرض لفتحه (مثال: "اختر 1") أو اطلب مزيداً من البحث.`
+    : `\n${'─'.repeat(40)}\n💡 Choose an offer number to open it (e.g. "select 1") or ask for more searching.`;
+
+  return header + offerLines.join('\n\n') + footer;
+}
+
+function _planSummary(plan, lang) {
+  const steps = plan.map(s => {
+    const desc = lang === 'ar' ? s.description_ar : s.description_en;
+    return `  ${s.id}. ${desc}`;
+  }).join('\n');
+
+  return lang === 'ar'
+    ? `📋 خطة العمل:\n${steps}\n\n⏳ جارٍ التنفيذ...`
+    : `📋 Execution plan:\n${steps}\n\n⏳ Executing...`;
+}
+
+// ─── Helpers ─────────────────────────────────────────────────────────
+
+function _addMessage(taskId, role, content, metadata = {}) {
+  stmts.insertMessage.run(crypto.randomUUID(), taskId, role, content, JSON.stringify(metadata));
+}
+
+function _updatePlan(taskId, plan) {
+  const task = stmts.getTask.get(taskId);
+  if (task) {
+    stmts.updateTask.run('planning', task.parsed_requirements,
+      task.clarifications, JSON.stringify(plan), 0,
+      task.offers, task.selected_offer, task.result, taskId);
+  }
+}
+
+function _detectLang(text) {
+  if (!text) return 'en';
+  const arChars = (text.match(/[\u0600-\u06FF]/g) || []).length;
+  return arChars > text.length * 0.2 ? 'ar' : 'en';
+}
+
+// ─── Exports ─────────────────────────────────────────────────────────
+
+module.exports = {
+  detectIntent,
+  extractRequirements,
+  parseBookingUrl,
+  createTask,
+  createUrlTask,
+  executeUrlTask,
+  answerClarification,
+  executeTask,
+  selectOffer,
+  getTaskState,
+  getSessionTasks,
+  cancelTask,
+  TRUSTED_SOURCES,
+};