beast-agent 0.27.0 → 0.28.0

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,

package/src/main.js

@@ -150,7 +150,9 @@ function startNpmUpdateWatch() {
   check();
   setInterval(check, 6 * 60 * 60 * 1000);
 }
-const { htmlToText, setExaKey, setTinyfishKey } = require('./agent/tools');
+const toolsMod = require('./agent/tools');
+const { htmlToText, setSearchChain, setSearchObscuraEnabled, setTinyfishKey } = toolsMod;
+const obscura = require('./agent/obscura');
 const { waToolLine } = require('./agent/watext');
 
 /* #3 merkezî log sistemine process-seviye hataları da düşsün */
@@ -219,8 +221,17 @@ let engine = null;
 let settings = loadSettings();
 ensureBeastCode();
 startHealthServer(); /* splash/boot aşamasından itibaren /health ayakta */
-try { setExaKey(settings.exaKey || null); } catch {}
+try { setSearchObscuraEnabled(settings.obscuraEnabled !== false); } catch {} /* Obscura varsayılan AKTİF */
+try { setSearchChain(settings.searchChain); } catch {}
 try { setTinyfishKey(settings.tinyfishKey || null); } catch {}
+/* kurulumda Obscura da kurulsun: yoksa ARKA PLANDA otomatik indir (UI kilitlenmez) */
+setTimeout(() => {
+  if (!obscura.obscuraInstalled()) {
+    obscura.installObscura().then((r) => {
+      console.log('[obscura]', r.ok ? 'kuruldu: ' + r.dir : 'kurulamadı: ' + (r.error || '?'));
+    }).catch((e) => console.log('[obscura] kurulamadı:', String((e && e.message) || e)));
+  }
+}, 4000).unref?.();
 let wa = null;
 let waChats = new Map(); // jid -> aktif session id
 let waHistory = new Map(); // jid -> [sid,...] bu sohbete ait tüm oturumlar
@@ -4118,7 +4129,7 @@ ipcMain.handle('agent:interrupt', (_e, sessionId) => {
       desktopQueue.delete(String(sessionId));
     }
   } catch {}
-  return engine.interrupt(sessionId);
+  return engine.interrupt(sessionId, 'kullanıcı sohbetteki durdurma (■) düğmesiyle iptal etti');
 });
 
 /* ---------- masaüstü sohbet birleştirme ----------
@@ -4482,7 +4493,9 @@ ipcMain.handle('memory:get', () => memory.loadAll());
 /* paralel ajanlar: canlı izleme (#14) */
 ipcMain.handle('agents:list', () => engine.listBgJobs());
 ipcMain.handle('agents:detail', (_e, id) => engine.bgDetail(id));
-ipcMain.handle('agents:cancel', (_e, id) => ({ ok: engine.interrupt(String(id || '')) }));
+ipcMain.handle('agents:cancel', (_e, id) => ({
+  ok: engine.interrupt(String(id || ''), 'kullanıcı Paralel Ajanlar panelinden (×) iptal etti'),
+}));
 ipcMain.handle('ceo:get', () => !!engine.ceoMode);
 ipcMain.handle('ceo:set', (_e, v) => {
   settings.ceoMode = !!v;
@@ -5190,7 +5203,7 @@ ipcMain.handle('beastcode:stop', () => {
   const sid = bcSessions.get(ideRoot());
   if (!sid) return { ok: false };
   let r = false;
-  try { r = engine.interrupt(sid); } catch {}
+  try { r = engine.interrupt(sid, 'kullanıcı Beast Code panelinden ■ ile durdurdu'); } catch {}
   return { ok: !!r };
 });
 
@@ -5211,26 +5224,38 @@ ipcMain.handle('think:set', (_e, v) => {
   return engine.publicState();
 });
 
-/* Exa web arama anahtarı (Ayarlar → Web Arama) */
-ipcMain.handle('exa:get', () => {
-  const k = settings.exaKey || '';
-  return { set: !!k, masked: k ? '••••••••' + k.slice(-4) : '' };
-});
-ipcMain.handle('exa:set', (_e, key) => {
-  const v = String(key || '').trim();
-  if (v) {
-    settings.exaKey = v;
-    saveSettings();
-    setExaKey(settings.exaKey);
+/* Obscura stealth headless tarayıcı (Ayarlar → Web Arama) */
+ipcMain.handle('obscura:get', () => ({
+  installed: obscura.obscuraInstalled(),
+  dir: obscura.obscuraDir(),
+  enabled: settings.obscuraEnabled !== false,
+}));
+ipcMain.handle('obscura:install', async () => {
+  try {
+    const r = await obscura.installObscura();
+    return { ok: !!r.ok, dir: r.dir || obscura.obscuraDir(), error: r.error || null };
+  } catch (e) {
+    return { ok: false, error: String((e && e.message) || e) };
   }
-  const k = settings.exaKey || '';
-  return { ok: true, set: !!k, masked: k ? '••••••••' + k.slice(-4) : '' };
 });
-ipcMain.handle('exa:clear', () => {
-  settings.exaKey = '';
+ipcMain.handle('obscura:setEnabled', (_e, v) => {
+  settings.obscuraEnabled = v !== false;
   saveSettings();
-  setExaKey(null);
-  return { ok: true, set: false, masked: '' };
+  try { setSearchObscuraEnabled(settings.obscuraEnabled); } catch {}
+  return { ok: true, enabled: settings.obscuraEnabled };
+});
+
+/* Arama zinciri sırası (Ayarlar → Web Arama'dan değiştirilir) */
+ipcMain.handle('searchorder:get', () => ({ chain: toolsMod.getSearchChain() }));
+ipcMain.handle('searchorder:set', (_e, chain) => {
+  try {
+    const rows = setSearchChain(chain);
+    settings.searchChain = rows;
+    saveSettings();
+    return { ok: true, chain: rows };
+  } catch (e) {
+    return { ok: false, error: String((e && e.message) || e) };
+  }
 });
 
 /* #TinyFish: anahtar girilirse web_search zincirinin BAŞINDA kullanılır */

package/src/preload.js

@@ -70,9 +70,11 @@ contextBridge.exposeInMainWorld('beast', {
   beastcodeStop: () => ipcRenderer.invoke('beastcode:stop'),
   beastcodeNew: () => ipcRenderer.invoke('beastcode:new'),
   thinkSet: (v) => ipcRenderer.invoke('think:set', v),
-  exaGet: () => ipcRenderer.invoke('exa:get'),
-  exaSet: (key) => ipcRenderer.invoke('exa:set', key),
-  exaClear: () => ipcRenderer.invoke('exa:clear'),
+  obscuraGet: () => ipcRenderer.invoke('obscura:get'),
+  obscuraInstall: () => ipcRenderer.invoke('obscura:install'),
+  obscuraSetEnabled: (v) => ipcRenderer.invoke('obscura:setEnabled', v),
+  searchOrderGet: () => ipcRenderer.invoke('searchorder:get'),
+  searchOrderSet: (chain) => ipcRenderer.invoke('searchorder:set', chain),
   tinyfishGet: () => ipcRenderer.invoke('tinyfish:get'),
   tinyfishSet: (key) => ipcRenderer.invoke('tinyfish:set', key),
   tinyfishClear: () => ipcRenderer.invoke('tinyfish:clear'),

package/src/renderer/i18n.js

@@ -111,10 +111,10 @@
       lim_saved_toast: 'Limitler kaydedildi',
       lim_unlimited: 'limitsiz',
       tf_h2: 'TinyFish Arama',
-      tf_sub: 'Ücretsiz, hızlı web arama API\u2019si. Anahtar girilirse web_search zincirinin EN BAŞINDA kullanılır; sonuç yoksa eski zincir (tarayıcı → çoklu-motor → Exa) devam eder.',
+      tf_sub: 'Ücretsiz, hızlı web arama API\u2019si. Anahtar girilirse zincirde KENDİ SIRASINDA kullanılır; anahtar yoksa motor otomatik atlanır.',
       tf_key_label: 'TinyFish API anahtarı (agent.tinyfish.ai/api-keys)',
       tf_status_set: 'TinyFish aktif — kayıtlı anahtar: ',
-      tf_status_unset: 'TinyFish pasif — eski arama zinciri kullanılıyor.',
+      tf_status_unset: 'TinyFish pasif — zincir sıradaki motorla devam eder.',
       tf_empty_toast: 'Anahtar boş — mevcut anahtar korundu',
       tf_saved_toast: 'TinyFish anahtarı kaydedildi',
       tf_cleared_toast: 'TinyFish anahtarı silindi',
@@ -260,18 +260,30 @@
       ws_calls: 'çağrı',
       ws_token: 'token',
       ws_h2: 'Web Arama',
-      ws_sub: 'Arama zinciri: 1) dahili tarayıcı (direk Google) 2) python çoklu-motor (ddgs / DDG+Bing+Mojeek) 3) Exa — otomatik. Exa anahtarı yalnızca son çare olarak kullanılır.',
-      ws_exa_label: 'Exa API anahtarı (exa.ai)',
-      ws_exa_ph: 'masaüstü görünümde maskeli',
+      ws_sub: 'Arama zinciri: 1) dahili tarayıcı (direk Google) 2) Obscura (stealth headless → DuckDuckGo) 3) TinyFish (anahtar varsa) 4) python çoklu-motor (ddgs / DDG+Bing+Mojeek) — otomatik. Sıra ve aç/kapa aşağıdan değiştirilir.',
+      oc_h2: 'Obscura (Stealth Tarayıcı)',
+      oc_sub: 'Rust tabanlı gizli headless tarayıcı (anti-detect + V8, Chromium\u2019suz). Kurulu değilse ilk açılışta otomatik indirilir (%APPDATA%\\beast\\obscura); DuckDuckGo aramasını bot korumasını aşarak yapar.',
+      oc_status_ok: 'Obscura kurulu ve hazır.',
+      oc_status_missing: 'Obscura kurulu değil — ilk açılışta otomatik indirilir (≈74 MB).',
+      oc_install: 'Kur / Güncelle',
+      oc_installing: 'İndiriliyor… (≈74 MB, bağlantıya göre birkaç dakika)',
+      oc_installed_toast: 'Obscura kuruldu',
+      oc_install_fail: 'Kurulamadı: ',
+      oc_enabled: 'Obscura arama zincirinde aktif',
+      oc_on_toast: 'Obscura aktif',
+      oc_off_toast: 'Obscura pasif',
+      so_h2: 'Arama Sırası',
+      so_sub: 'Motorlar bu sırayla denenir; boş dönen motor atlanıp sıradaki devreye girer. ↑↓ ile sırayı, kutucukla aç/kapa durumunu değiştir.',
+      so_engine_browser: 'Dahili Tarayıcı (Google)',
+      so_engine_obscura: 'Obscura (Stealth → DuckDuckGo)',
+      so_engine_tinyfish: 'TinyFish API (anahtar gerekir)',
+      so_engine_python: 'Python Çoklu-Motor (ddgs/DDG/Bing/Mojeek)',
+      so_saved_toast: 'Arama sırası kaydedildi',
       ws_save: 'Kaydet',
       ws_clear: 'Anahtarı Sil',
       ws_note: 'Anahtar maskeli tutulur; yenisini yazıp kaydettiğinde eskisinin yerine geçer. Boş kaydet: mevcut anahtar korunur.',
-      ws_status_set: 'Exa aktif — kayıtlı anahtar: ',
-      ws_status_unset: 'Exa yapılandırılmadı — ücretsiz python çoklu-motor arama kullanılıyor.',
       ws_empty_toast: 'Anahtar boş — mevcut anahtar korundu',
-      ws_saved_toast: 'Exa anahtarı kaydedildi',
       ws_fail_toast: 'Kaydedilemedi',
-      ws_cleared_toast: 'Exa anahtarı silindi',
       ag_h2: 'Paralel Ajanlar',
       ag_sub: 'CEO\u2019nun devrettiği arka plan işleri — canlı izleme',
       ag_ceo_label: 'CEO modu — konuşan ajan iş yapmaz, sadece emir verir',
@@ -300,12 +312,11 @@
       us_where_on_toast: 'Açılış özeti açık',
       us_where_off_toast: 'Açılış özeti kapandı',
       ws_h2: 'Web Arama',
-      ws_exa_label: 'Exa API anahtarı (exa.ai)',
+      oc_status_ok: 'Obscura kurulu ve hazır.',
+      oc_status_missing: 'Obscura kurulu değil — ilk açılışta otomatik indirilir.',
       ws_save: 'Kaydet',
       ws_clear: 'Anahtarı Sil',
       ws_key_note: 'Anahtar maskeli tutulur; yenisini yazıp kaydettiğinde eskisinin yerine geçer. Boş kaydet: mevcut anahtar korunur.',
-      ws_active: 'Exa aktif — kayıtlı anahtar: ',
-      ws_notcfg: 'Exa yapılandırılmadı — ücretsiz python çoklu-motor arama kullanılıyor.',
       ws_empty: 'Anahtar boş — mevcut anahtar korundu',
       // terminal & tarayıcı & mini
       term_clear: 'Temizle',
@@ -641,10 +652,10 @@
       lim_saved_toast: 'Limits saved',
       lim_unlimited: 'unlimited',
       tf_h2: 'TinyFish Search',
-      tf_sub: 'Free, fast web search API. If a key is set it is used at the TOP of the web_search chain; otherwise the old chain (browser → multi-engine → Exa) continues.',
+      tf_sub: 'Free, fast web search API. If a key is set it is used in its own slot of the chain; without a key the engine is skipped automatically.',
       tf_key_label: 'TinyFish API key (agent.tinyfish.ai/api-keys)',
       tf_status_set: 'TinyFish active — saved key: ',
-      tf_status_unset: 'TinyFish off — using the old search chain.',
+      tf_status_unset: 'TinyFish off — the chain continues with the next engine.',
       tf_empty_toast: 'Key empty — current key kept',
       tf_saved_toast: 'TinyFish key saved',
       tf_cleared_toast: 'TinyFish key deleted',
@@ -790,18 +801,30 @@
       ws_calls: 'calls',
       ws_token: 'tokens',
       ws_h2: 'Web Search',
-      ws_sub: 'Search chain: 1) built-in browser (direct Google) 2) python multi-engine (ddgs / DDG+Bing+Mojeek) 3) Exa — automatic. The Exa key is only used as a last resort.',
-      ws_exa_label: 'Exa API key (exa.ai)',
-      ws_exa_ph: 'masked on desktop view',
+      ws_sub: 'Search chain: 1) built-in browser (direct Google) 2) Obscura (stealth headless → DuckDuckGo) 3) TinyFish (if a key is set) 4) python multi-engine (ddgs / DDG+Bing+Mojeek) — automatic. Order and on/off are editable below.',
+      oc_h2: 'Obscura (Stealth Browser)',
+      oc_sub: 'Rust-based stealth headless browser (anti-detect + V8, no Chromium). If not installed it is auto-downloaded at first launch (%APPDATA%\\beast\\obscura); it searches DuckDuckGo past bot protection.',
+      oc_status_ok: 'Obscura is installed and ready.',
+      oc_status_missing: 'Obscura is not installed — it is auto-downloaded at first launch (≈74 MB).',
+      oc_install: 'Install / Update',
+      oc_installing: 'Downloading… (≈74 MB, may take a few minutes)',
+      oc_installed_toast: 'Obscura installed',
+      oc_install_fail: 'Install failed: ',
+      oc_enabled: 'Obscura active in the search chain',
+      oc_on_toast: 'Obscura enabled',
+      oc_off_toast: 'Obscura disabled',
+      so_h2: 'Search Order',
+      so_sub: 'Engines are tried in this order; an empty engine is skipped and the next one takes over. Use ↑↓ to reorder, checkbox to enable/disable.',
+      so_engine_browser: 'Built-in Browser (Google)',
+      so_engine_obscura: 'Obscura (Stealth → DuckDuckGo)',
+      so_engine_tinyfish: 'TinyFish API (needs a key)',
+      so_engine_python: 'Python Multi-Engine (ddgs/DDG/Bing/Mojeek)',
+      so_saved_toast: 'Search order saved',
       ws_save: 'Save',
       ws_clear: 'Delete Key',
       ws_note: 'The key is kept masked; saving a new one replaces the old. Saving empty keeps the current key.',
-      ws_status_set: 'Exa active — saved key: ',
-      ws_status_unset: 'Exa not configured — using free python multi-engine search.',
       ws_empty_toast: 'Key empty — current key kept',
-      ws_saved_toast: 'Exa key saved',
       ws_fail_toast: 'Could not save',
-      ws_cleared_toast: 'Exa key deleted',
       ag_h2: 'Parallel Agents',
       ag_sub: 'Background tasks delegated by the CEO — live monitoring',
       ag_ceo_label: 'CEO mode — the talking agent does no work, only gives orders',
@@ -892,12 +915,11 @@
       us_where_on_toast: 'Startup summary on',
       us_where_off_toast: 'Startup summary off',
       ws_h2: 'Web Search',
-      ws_exa_label: 'Exa API key (exa.ai)',
+      oc_status_ok: 'Obscura is installed and ready.',
+      oc_status_missing: 'Obscura is not installed — it is auto-downloaded at first launch.',
       ws_save: 'Save',
       ws_clear: 'Delete Key',
       ws_key_note: 'Key is kept masked; saving a new one replaces the old. Save empty: existing key kept.',
-      ws_active: 'Exa active — saved key: ',
-      ws_notcfg: 'Exa not configured — free python multi-engine search is used.',
       ws_empty: 'Key empty — existing key kept',
       term_clear: 'Clear',
       term_ph: 'type a command, press Enter…',