beast-agent 0.27.0 → 0.29.0

package/src/agent/obscura.js

@@ -0,0 +1,276 @@
+'use strict';
+
+/* ---------- Obscura entegrasyonu ----------
+   Obscura (github.com/h4ckf0r0day/obscura): Rust tabanlı stealth headless
+   tarayıcı — anti-detect + V8 JS + gerçek rendering, Chromium'suz.
+   Beast kullanımı:
+   1) Kurulum: releases'taki Windows stealth zip'i %APPDATA%\beast\obscura'ya
+      açılır (obscura.exe + obscura-worker.exe). İlk açılışta OTOMATİK kurulur.
+   2) Arama: `obscura fetch https://html.duckduckgo.com/html/?q=...` çıktısı
+      DDG sonuç ayrıştırıcısıyla results'a döner — web_search zincirinin
+      sıralı bir motoru (Ayarlar → Web Arama'dan sıra değiştirilebilir). */
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const https = require('https');
+const { execFile, spawn } = require('child_process');
+
+const RELEASE_BASE = 'https://github.com/h4ckf0r0day/obscura/releases/latest/download/';
+const WINDOWS_ZIP = 'obscura-x86_64-windows-stealth.zip';
+const MAX_ZIP_BYTES = 250 * 1024 * 1024;
+const FETCH_TIMEOUT_MS = 25000;
+/* content-length gelmezse yüzde tahmini için yaklaşık boyut (stealth zip ≈74 MB) */
+const EST_ZIP_BYTES = 74 * 1024 * 1024;
+
+function obscuraDir() {
+  const base = process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming');
+  return path.join(base, 'beast', 'obscura');
+}
+
+function obscuraExe() {
+  return path.join(obscuraDir(), 'obscura.exe');
+}
+
+function obscuraInstalled() {
+  try { return fs.existsSync(obscuraExe()); } catch { return false; }
+}
+
+/* kurulan varyant işareti: stealth zip'te --stealth bayrağı geçerli */
+function markVariant(v) {
+  try { fs.writeFileSync(path.join(obscuraDir(), 'variant.txt'), String(v || 'stealth') + '\n', 'utf8'); } catch {}
+}
+
+function readVariant() {
+  try { return String(fs.readFileSync(path.join(obscuraDir(), 'variant.txt'), 'utf8')).trim() || 'stealth'; } catch { return 'stealth'; }
+}
+
+/* bina sağ mı: --help 10 sn içinde cevap veriyor mu (oturum başına tek deneme) */
+let _okProbe = null;
+function obscuraOk() {
+  if (!obscuraInstalled()) return Promise.resolve(false);
+  if (_okProbe) return _okProbe;
+  _okProbe = new Promise((resolve) => {
+    try {
+      execFile(obscuraExe(), ['--help'], { timeout: 10000, windowsHide: true }, (err) => resolve(!err));
+    } catch {
+      resolve(false);
+    }
+  });
+  return _okProbe;
+}
+
+function httpsDownload(url, redirectsLeft = 5, signal, onProgress) {
+  return new Promise((resolve, reject) => {
+    const req = https.get(url, { headers: { 'User-Agent': 'BeastAgent/1.0 (+obscura bootstrap)' } }, (res) => {
+      if ([301, 302, 303, 307, 308].includes(res.statusCode) && res.headers.location && redirectsLeft > 0) {
+        res.resume();
+        return resolve(httpsDownload(new URL(res.headers.location, url).toString(), redirectsLeft - 1, signal, onProgress));
+      }
+      if (res.statusCode !== 200) {
+        res.resume();
+        return reject(new Error(`indirme başarısız: HTTP ${res.statusCode}`));
+      }
+      const total = Number(res.headers['content-length']) || EST_ZIP_BYTES;
+      const chunks = [];
+      let size = 0;
+      let lastPct = -1;
+      const tick = () => {
+        /* yüzdeyi INDIRME fazının %1-88 aralığına map et; %1'lik adımda bildir */
+        const pct = 1 + Math.min(88, Math.floor((size / total) * 88));
+        if (typeof onProgress === 'function' && pct !== lastPct) {
+          lastPct = pct;
+          try { onProgress({ pct, phase: 'indiriliyor', loaded: size, total }); } catch {}
+        }
+      };
+      res.on('data', (c) => {
+        size += c.length;
+        if (size > MAX_ZIP_BYTES) {
+          req.destroy(new Error('dosya çok büyük'));
+          return;
+        }
+        chunks.push(c);
+        tick();
+      });
+      res.on('end', () => {
+        tick();
+        resolve(Buffer.concat(chunks));
+      });
+      res.on('error', reject);
+    });
+    req.on('error', reject);
+    if (signal) {
+      if (signal.aborted) return reject(new Error('iptal'));
+      signal.addEventListener('abort', () => req.destroy(new Error('iptal')), { once: true });
+    }
+  });
+}
+
+function psExpand(zipPath, destDir) {
+  return new Promise((resolve) => {
+    const cmd = `Expand-Archive -LiteralPath "${zipPath}" -DestinationPath "${destDir}" -Force`;
+    const child = spawn(
+      'powershell.exe',
+      ['-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-Command', cmd],
+      { windowsHide: true }
+    );
+    let err = '';
+    const finish = (ok) => {
+      clearTimeout(timer);
+      resolve(ok);
+    };
+    const timer = setTimeout(() => {
+      try { spawn('taskkill', ['/pid', String(child.pid), '/T', '/F'], { windowsHide: true }); } catch {}
+      finish(false);
+    }, 180000);
+    child.stderr.setEncoding('utf8');
+    child.stderr.on('data', (d) => { err += d; });
+    child.on('error', () => finish(false));
+    child.on('close', (code) => finish(code === 0 && !/Expand-Archive :/i.test(err)));
+  });
+}
+
+/* Obscura'yı kur / güncelle (yeniden indirip üzerine yazar).
+   onProgress({pct, phase}) — 1-88 indirme, 89-96 açma, 97-99 doğrulama. */
+async function installObscura(signal, onProgress) {
+  const tick = (pct, phase) => {
+    if (typeof onProgress === 'function') {
+      try { onProgress({ pct, phase: phase || 'indiriliyor' }); } catch {}
+    }
+  };
+  try {
+    tick(0, 'hazırlanıyor');
+    const dest = obscuraDir();
+    fs.mkdirSync(dest, { recursive: true });
+    const zipPath = path.join(os.tmpdir(), 'beast-obscura.zip');
+    const buf = await httpsDownload(RELEASE_BASE + WINDOWS_ZIP, 5, signal, onProgress);
+    tick(89, 'kuruluyor');
+    fs.writeFileSync(zipPath, buf);
+    tick(90, 'kuruluyor');
+    const ok = await psExpand(zipPath, dest);
+    try { fs.unlinkSync(zipPath); } catch {}
+    tick(97, 'doğrulanıyor');
+    if (!ok || !obscuraInstalled()) {
+      return { ok: false, error: 'obscura kurulumu başarısız (zip açılamadı)' };
+    }
+    markVariant('stealth');
+    _okProbe = null; /* yeniden doğrula */
+    const good = await obscuraOk();
+    tick(good ? 100 : 98, good ? 'tamamlandı' : 'doğrulanıyor');
+    return { ok: good, dir: dest, error: good ? null : 'obscura.exe doğrulanamadı' };
+  } catch (e) {
+    return { ok: false, error: String((e && e.message) || e) };
+  }
+}
+
+/* obscura fetch — sayfa HTML'i (abort ile süreç kesilir) */
+function obscuraFetchHtml(url, signal, timeoutMs = FETCH_TIMEOUT_MS) {
+  return new Promise((resolve, reject) => {
+    const args = ['fetch', url, '--dump', 'html', '--quiet', '--timeout', '20'];
+    if (readVariant() === 'stealth') args.push('--stealth');
+    let settled = false;
+    const finish = (err, html) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      if (signal) signal.removeEventListener('abort', onAbort);
+      err ? reject(err) : resolve(String(html || ''));
+    };
+    let child = null;
+    const onAbort = () => {
+      try {
+        if (child && child.pid) spawn('taskkill', ['/pid', String(child.pid), '/T', '/F'], { windowsHide: true });
+      } catch {}
+      finish(new Error('obscura fetch iptal edildi'));
+    };
+    const timer = setTimeout(() => {
+      try {
+        if (child && child.pid) spawn('taskkill', ['/pid', String(child.pid), '/T', '/F'], { windowsHide: true });
+      } catch {}
+      finish(new Error('obscura fetch zaman aşımı'));
+    }, timeoutMs);
+    if (signal) {
+      if (signal.aborted) return finish(new Error('iptal'));
+      signal.addEventListener('abort', onAbort, { once: true });
+    }
+    try {
+      child = execFile(
+        obscuraExe(),
+        args,
+        { timeout: timeoutMs, windowsHide: true, maxBuffer: 8 * 1024 * 1024 },
+        (err, stdout) => finish(err, stdout)
+      );
+    } catch (e) {
+      finish(e);
+    }
+  });
+}
+
+/* lite.duckduckgo sonuç ayrıştırıcı (tablo düzeni, result-link çıpaları) */
+function parseDdgLite(html, limit = 8) {
+  const out = [];
+  const re = /<a\s+[^>]*class="[^"]*result-link[^"]*"[^>]*href="([^"]+)"[^>]*>([\s\S]*?)<\/a>/g;
+  let m;
+  while ((m = re.exec(String(html || ''))) && out.length < limit) {
+    let href = m[1] || '';
+    try {
+      const u = new URL(href, 'https://duckduckgo.com');
+      const uddg = u.searchParams.get('uddg');
+      href = uddg ? decodeURIComponent(uddg) : u.toString();
+    } catch {}
+    const title = String(m[2] || '').replace(/<[^>]+>/g, '').trim();
+    if (!title || !/^https?:\/\//i.test(href)) continue;
+    if (out.some((r) => r.url === href)) continue;
+    out.push({ title, url: href, snippet: '' });
+  }
+  return out;
+}
+
+/* Obscura arama motoru: DDG html (önce) → DDG lite (yedek), stealth ile.
+   Döndüremiyorsa null — zincir sıradaki motora geçer. */
+async function obscuraSearch(query, { maxResults = 8, signal } = {}) {
+  const q = String(query || '').trim().slice(0, 400);
+  if (!q || !obscuraInstalled()) return null;
+  const cap = Math.max(1, Math.min(12, Number(maxResults) || 8));
+  const targets = [
+    'https://html.duckduckgo.com/html/?q=' + encodeURIComponent(q),
+    'https://lite.duckduckgo.com/lite/?q=' + encodeURIComponent(q),
+  ];
+  for (const url of targets) {
+    let html = '';
+    try {
+      html = await obscuraFetchHtml(url, signal);
+    } catch {
+      continue;
+    }
+    if (!html) continue;
+    let results = [];
+    const { parseDdgResults } = require('./tools'); /* döngüsel require — çağrı anında */
+    if (/result__a/.test(html)) results = parseDdgResults(html, cap);
+    if (!results.length) results = parseDdgLite(html, cap);
+    if (results.length) {
+      return {
+        ok: true,
+        engine: 'obscura',
+        query: q,
+        count: results.length,
+        results: results.map((r) => ({ ...r, engine: 'obscura' })),
+      };
+    }
+  }
+  return null;
+}
+
+module.exports = {
+  ENGINE: 'obscura',
+  RELEASE_BASE,
+  WINDOWS_ZIP,
+  obscuraDir,
+  obscuraExe,
+  obscuraInstalled,
+  obscuraOk,
+  installObscura,
+  obscuraFetchHtml,
+  obscuraSearch,
+  parseDdgLite,
+};

package/src/agent/skills.js

@@ -164,19 +164,27 @@ Send-MailMessage -SmtpServer smtp.gmail.com -Port 587 -UseSsl -From 'adres@gmail
     force: true,
     body: `---
 name: python-web-search
-description: VARSAYILAN web arama zinciri — 1) dahili tarayıcı DİREK GOOGLE (gerçek Chromium, bot koruması yok; Google AI cevabi 'ai' alanında hazır gelir) 2) python çoklu-motor (ddgs / DDG+Bing+Mojeek, anahtarsız) 3) Exa (son çare, anahtar varsa). Takılmama kuralları içerir.
-version: 1.3.2
+description: VARSAYILAN web arama zinciri — 1) dahili tarayıcı DİREK GOOGLE (gerçek Chromium, bot koruması yok; Google AI cevabi 'ai' alanında hazır gelir) 2) Obscura (stealth headless → DuckDuckGo; otomatik kurulur, varsayılan AKTİF) 3) TinyFish (anahtar varsa) 4) python çoklu-motor (ddgs / DDG+Bing+Mojeek, anahtarsız). Sıra Ayarlar → Web Arama'dan değiştirilir. Takılmama kuralları içerir.
+version: 1.4.0
 ---
 
 # Web Arama Zinciri (VARSAYILAN)
 
-web_search aracı çağrıldığında zincir OTOMATİK çalışır — elle motor seçmen gerekmez:
+web_search aracı çağrıldığında zincir OTOMATİK çalışır — elle motor seçmen gerekmez. Sıra Ayarlar → Web Arama sekmesinden değiştirilebilir:
 
 ## 1. Dahili tarayıcı (ilk tercih — Google AI)
 
-Gerçek Chromium olduğu için Google'a bot koruması uygulamaz. Arama aep=1 ile açılır: Google'ın KENDİ AI cevabı yanıtın 'ai' alanında HAZIR gelir — "kimdir/nedir" sorularında önce onu kullan, kaynak linkleri de 'results' alanında gelir. Sağ panelde açılır, kullanıcı da görebilir.
+Gerçek Chromium olduğu için Google'a bot koruması uygulamaz. Arama aep=1 ile açılır: Google'ın KENDİ AI cevabı yanıtın 'ai' alanında HAZIR gelir — "kimdir/nedir" sorularında önce onu kullan, kaynak linkleri de 'results' alanında gelir. Sağ panelde açılır, kullanıcı da görebilir. CAPTCHA/trafik uyarısı gelirse tarayıcı 10 dk atlanır, sıradaki motor devreye girer.
 
-## 2. Python çoklu-motor (tarayıcı sonuç vermezse)
+## 2. Obscura (stealth headless — DuckDuckGo)
+
+Rust tabanlı gizli tarayıcı: anti-detect parmak izi + V8 JS. Kurulu değilse uygulama açılışında OTOMATİK indirilir (%APPDATA%\\beast\\obscura). Varsayılan AKTİF — tarayıcı engellenirse bot korumasını aşarak DuckDuckGo'dan sonuç getirir.
+
+## 3. TinyFish API (anahtar varsa)
+
+Ayarlar → Web Arama'dan anahtar girildiyse kendi sırasında devreye girer; anahtar yoksa otomatik atlanır.
+
+## 4. Python çoklu-motor
 
 ddgs kütüphanesi (github.com/deedy5/ddgs — anti-bot korumalı metasearch) veya DuckDuckGo + Bing + Mojeek PARALEL — anahtar gerekmez. Gömülü Python runtime otomatik yönetilir.
 
@@ -187,10 +195,6 @@ web_search {"query": "sorgu", "max_results": 6}
 - Çoklu sorgu gerekiyorsa: aynı turda birden ÇOK web_search çağrısını PARALEL ver — toplam süre tek arama kadar olur.
 - Sonuç listesinden 1-2 URL'nin içeriğini okumak için http_fetch kullan.
 
-## 3. Exa (son çare)
-
-Yukarıdakiler boş dönerse ve Ayarlar → Web Arama'ya Exa anahtarı girildiyse devreye girer.
-
 ## Toplu / derin işler (python_run)
 
 - Haber başlıkları: python_run script=news.py args ["--limit","8","--json"]
@@ -208,7 +212,7 @@ for q in ["sorgu 1", "sorgu 2", "sorgu 3"]:
 
 - Bir bilgi 2-3 farklı sorguyla bulunamıyorsa PEŞİNİ BIRAK: bulduğun kısmi bilgiyle devam et, neyi bulamadığını raporda açıkça yaz.
 - Kapalı/gizli içerik (Instagram gizli hesap, private profil, login arkası veri) ARANMAZ — bulunamayacağı belliyse hemen alternatif kaynağa/geçişe geç.
-- DDG boş/engelli dönerse "DuckDuckGo kapandı" DEME: bot koruması devrededir (~1 saatte kendiliğinden açılır) ve zincir otomatik olarak Bing/Mojeek/tarayıcıya geçer — bu normal çalışmadır.
+- DDG boş/engelli dönerse "DuckDuckGo kapandı" DEME: bot koruması devrededir (~1 saatte kendiliğinden açılır) ve zincir otomatik olarak Obscura/Bing/Mojeek/tarayıcıya geçer — bu normal çalışmadır.
 - Araştırma hedefi: ~3 dakika, 3-5 kaynak. Derinleşme = zaman kaybı.
 - Motor hata verirse bir kez farklı sorguyla dene, sonra elindekiyle raporu kapat.`,
   },

package/src/agent/tools.js

@@ -7,6 +7,7 @@ const https = require('https');
 const { execFile } = require('child_process');
 const { spawn } = require('child_process');
 const research = require('./research');
+const obscura = require('./obscura');
 
 const MAX_CMD_OUTPUT = 16000;
 const MAX_FILE_CHARS = 200000;
@@ -627,7 +628,7 @@ const definitions = [
     function: {
       name: 'web_search',
       description:
-        'FAST web search with an automatic chain: built-in browser first (real Chromium searching GOOGLE directly with AI Mode — no bot protection; the response may include an `ai` field holding Google\'s own AI answer, ideal for "who/what is X" questions), then TinyFish API (if a key is configured, used IMMEDIATELY whenever the browser hits CAPTCHA/unusual traffic — the browser is then skipped for 10 minutes), then Python multi-engine (ddgs / DuckDuckGo+Bing+Mojeek parallel), then Exa API as last resort if a key is configured (Ayarlar → Web Arama). Returns {ai?, results[{title,url,snippet}]}. Use when fresh or external info is needed; skip for things you already know.',
+        'FAST web search with an automatic chain (order is configurable in Ayarlar → Web Arama): built-in browser (real Chromium searching GOOGLE directly with AI Mode — no bot protection; the response may include an `ai` field holding Google\'s own AI answer), Obscura stealth headless browser (anti-detect; searches DuckDuckGo, installed automatically and ACTIVE by default), TinyFish API (only if a key is configured), then Python multi-engine (ddgs / DuckDuckGo+Bing+Mojeek). If the browser hits CAPTCHA/unusual traffic it is skipped for 10 minutes and the next engine takes over. Returns {ai?, results[{title,url,snippet}]}. Use when fresh or external info is needed; skip for things you already know.',
       parameters: {
         type: 'object',
         properties: {
@@ -758,13 +759,9 @@ async function exec(name, args, ctx) {
       case 'web_search': {
         const q = String(args.query || '');
         const n = Number(args.max_results) || 8;
-        /* önce ücretsiz python çoklu-motor; Exa SON ÇARE (dahili tarayıcı zincirin
-           üstünde engine._execTool'da çalışır) */
-        let r = await webSearchFast(q, { maxResults: n, signal: ctx.signal });
-        if (!r || !r.ok || !(r.results || []).length) {
-          const exa = await exaSearch(q, n, ctx.signal);
-          if (exa) return JSON.stringify(exa);
-        }
+        /* sıralı zincir (obscura/tinyfish/python — dahili tarayıcı engine
+           tarafındaki hook'tan gelir); Exa KALDIRILDI */
+        const r = await searchChainWeb(q, n, { signal: ctx.signal });
         return JSON.stringify(r);
       }
       case 'deep_search': {
@@ -772,7 +769,7 @@ async function exec(name, args, ctx) {
            Gizli tarayıcı okuması engine.research hook'undan gelir (main process). */
         const r = await research.deepSearch(
           args,
-          { search: (q) => webSearchFast(q, { maxResults: 10, signal: ctx.signal }) },
+          { search: (q) => searchChainWeb(q, 10, { signal: ctx.signal }) },
           ctx.signal
         );
         return JSON.stringify(r);
@@ -836,53 +833,101 @@ async function exec(name, args, ctx) {
   }
 }
 
-/* ---------- Exa (opsiyonel ücretli arama) ----------
-   Ayarlar → Web Arama'dan anahtar girilirse web_search ÖNCE Exa'yı dener;
-   hata/sonuç yoksa ücretsiz python çoklu-motor devreye girer. */
-let _exaKey = null;
+/* ---------- Sıralı arama zinciri (Ayarlar → Web Arama'dan değiştirilir) ----------
+   Motorlar: browser (dahili Chromium → Google) · obscura (stealth headless →
+   DuckDuckGo) · tinyfish (API, anahtar gerekir) · python (ddgs/DDG+Bing+Mojeek).
+   Sıra + aç/kapa ayarı settings.json'da (searchChain) saklanır; Obscura
+   varsayılan AKTİF. Tarayıcı CAPTCHA/trafik verirse 10 dk atlanır. */
+const SEARCH_ENGINE_IDS = ['browser', 'obscura', 'tinyfish', 'python'];
+const DEFAULT_SEARCH_CHAIN = SEARCH_ENGINE_IDS.map((id) => ({ id, on: true }));
+
+let _searchChain = DEFAULT_SEARCH_CHAIN.map((x) => ({ ...x }));
+let _obscuraEnabled = true; /* Obscura varsayılan AKTİF */
+let _browserBanUntil = 0;
+
+function normalizeSearchChain(list) {
+  const arr = Array.isArray(list) ? list : [];
+  const rows = [];
+  const seen = new Set();
+  for (const item of arr) {
+    const id = String((item && item.id) || item || '').trim();
+    if (!SEARCH_ENGINE_IDS.includes(id) || seen.has(id)) continue;
+    seen.add(id);
+    rows.push({ id, on: !(item && item.on === false) });
+  }
+  for (const id of SEARCH_ENGINE_IDS) {
+    if (!seen.has(id)) rows.push({ id, on: true }); /* listede eksik motor varsayılan AÇIK */
+  }
+  /* obscura varsayılan AKTİF; zincir boş kalmasın: hepsi kapalıysa browser'ı aç */
+  if (!rows.some((r) => r.on)) {
+    const b = rows.find((r) => r.id === 'browser');
+    if (b) b.on = true;
+  }
+  return rows;
+}
 
-function setExaKey(key) {
-  _exaKey = String(key || '').trim() || null;
+function setSearchChain(list) {
+  _searchChain = normalizeSearchChain(list);
+  return _searchChain;
 }
 
-async function exaSearch(query, maxResults, signal) {
-  if (!_exaKey) return null;
-  try {
-    const sig =
-      signal && typeof AbortSignal !== 'undefined' && AbortSignal.any
-        ? AbortSignal.any([signal, AbortSignal.timeout(20000)])
-        : AbortSignal.timeout(20000);
-    const r = await fetch('https://api.exa.ai/search', {
-      method: 'POST',
-      headers: { 'x-api-key': _exaKey, 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        query,
-        numResults: Math.max(1, Math.min(12, Number(maxResults) || 8)),
-        contents: { text: { maxCharacters: 1200 } },
-      }),
-      signal: sig,
-    });
-    if (!r.ok) return null;
-    const j = await r.json();
-    const results = (j.results || [])
-      .map((x) => ({
-        title: String(x.title || ''),
-        url: String(x.url || ''),
-        snippet: String(x.text || '').replace(/\s+/g, ' ').slice(0, 400),
-        engine: 'exa',
-      }))
-      .filter((x) => x.url && x.title);
-    if (!results.length) return null;
-    return { ok: true, engine: 'exa', query, results };
-  } catch {
-    return null;
+function setSearchObscuraEnabled(v) {
+  _obscuraEnabled = v !== false;
+}
+
+function getSearchChain() {
+  return _searchChain.map((x) => ({ ...x }));
+}
+
+function browserBanned() {
+  return Date.now() < _browserBanUntil;
+}
+
+function banBrowser(minutes = 10) {
+  _browserBanUntil = Date.now() + minutes * 60 * 1000;
+}
+
+/* Zinciri sırayla koştur: her motor boş/hata dönerse sıradakine geç.
+   browser motoru yalnız engine'den gelir (hook); araç-bağımsız çağrılarda atlanır. */
+async function searchChainWeb(query, maxResults, { signal, browser } = {}) {
+  const q = String(query || '').trim().slice(0, 400);
+  if (!q) return { ok: false, error: 'boş sorgu' };
+  const cap = Math.max(1, Math.min(12, Number(maxResults) || 8));
+  let out = null;
+  const banned = browserBanned();
+  for (const row of _searchChain) {
+    if (out && out.ok && (out.results || []).length) break;
+    if (!row.on) continue;
+    try {
+      if (row.id === 'browser') {
+        if (typeof browser !== 'function' || banned) continue;
+        out = await browser();
+        if (!out || !out.ok || !(out.results || []).length) {
+          banBrowser(); /* tarayıcı sorunlu — 10 dk atla, alternatifler devrede */
+          out = null;
+        }
+      } else if (row.id === 'obscura') {
+        if (!_obscuraEnabled) continue;
+        out = await obscura.obscuraSearch(q, { maxResults: cap, signal });
+      } else if (row.id === 'tinyfish') {
+        out = await tinyfishSearch(q, cap, signal);
+      } else if (row.id === 'python') {
+        out = await webSearchFast(q, { maxResults: cap, signal });
+      }
+    } catch {
+      out = null;
+    }
+    if (out && out.ok && !(out.results || []).length) out = null; /* boş → sıradaki motor */
+  }
+  if (out && out.ok && banned && (out.results || []).length) {
+    out.note = 'dahili tarayıcı 10 dk askıda (CAPTCHA/trafik) — alternatif motor kullanıldı';
   }
+  return out || { ok: false, error: 'web arama başarısız — tüm motorlar boş döndü' };
 }
 
-/* ---------- TinyFish (ücretsiz arama; anahtar girilirse ZİNCİRİN BAŞI) ----------
+/* ---------- TinyFish (anahtar girilirse zincirdeki kendi sırasında) ----------
    GET https://api.search.tinyfish.ai?query=...  ·  Header: X-API-Key
-   Ayarlar → Web Arama'dan anahtar girilirse web_search ÖNCE TinyFish'i dener;
-   hata/sonuç yoksa eski zincir (tarayıcı → python çoklu-motor → Exa) devam eder. */
+   Anahtar yoksa bu motor otomatik atlanır; sıradaki motor devreye girer. */
 let _tinyfishKey = null;
 
 function setTinyfishKey(key) {
@@ -936,10 +981,19 @@ module.exports = {
   webSearchFast,
   seedScript,
   bundledScriptPath,
-  setExaKey,
-  exaSearch,
+  /* arama zinciri (sıra + aç/kapa Ayarlar → Web Arama'dan) */
+  SEARCH_ENGINE_IDS,
+  DEFAULT_SEARCH_CHAIN,
+  setSearchChain,
+  setSearchObscuraEnabled,
+  getSearchChain,
+  searchChainWeb,
+  browserBanned,
+  banBrowser,
   setTinyfishKey,
   tinyfishSearch,
+  /* obscura geçişi */
+  obscura,
   /* python altyapısı */
   ensurePython,
   findSystemPython,