beast-agent 0.26.5 → 0.28.0

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "beast-agent",
     "productName": "Beast Agent",
-    "version": "0.26.5",
+    "version": "0.28.0",
     "description": "Ultra-fast local agent shell for Windows.",
     "author": "algokodcom (AlgoKod)",
     "license": "MIT",

package/src/agent/engine.js

@@ -19,6 +19,9 @@ const SUB_MAX_TURNS = 8;
 const HISTORY_TOKEN_BUDGET = 18000;
 const TOOL_OUT_KEEP = 1200;
 const USER_MAX = 8000;
+/* observe() ile enjekte edilen bağlam mesajlarının öneki — ardışık bağlam
+   mesajlarının tek mesajda birleşmesi bu işaretle anlaşılır */
+const OBSERVE_MARK = '[BAĞLAM';
 
 /* Oturum notları (geçici hafıza): eski mesajlar bütçeden düşülmeden önce
    önemli noktalar çıkarılır, sistem promptuna küçük blok olarak girer. */
@@ -1170,6 +1173,8 @@ class Engine {
     try {
       const c = this.ctrls.get(id);
       if (c) {
+        this._abortReasons = this._abortReasons || new Map();
+        this._abortReasons.set(String(id), 'oturum silindiği için tur iptal edildi');
         c.abort();
         this.ctrls.delete(id);
       }
@@ -1179,6 +1184,7 @@ class Engine {
         const j = this._bgJobs.get(String(id));
         j.revive = false;
         j.status = 'aborted';
+        j.error = j.error || 'oturum silindi — paralel ajan iptal edildi';
         this._clearKicks(id);
       }
       fs.unlinkSync(this._file(String(id)));
@@ -1313,7 +1319,7 @@ class Engine {
           'Tarayıcı eylemlerinin yanıtındaki recent günlüğü ve navigated bilgisini takip et; eylem yanıtları zaten taze snapshot içerir — refler tutarsız görünürse yeni snapshot al.',
           'CONUŞMA ODAĞI SENDE KALSIN: kullanıcı seninle konuşurken iş çıkmışsa — uzun da olsa UFACIK da (tek komutluk dizin listesi, tek dosya okuma, tek arama…) — run_background ile PARALEL ajana devret; ana sohbet hiçbir işi beklemez; bittiğinde özet otomatik düşer.',
           'Python işleri için python_run kullan: küçük betikler inline code ile; tekrarlayan işler %APPDATA%\\beast\\scripts klasöründeki dosyalarla (ör. news.py = RSS haber toplayıcı: args ["--limit","8","--json"]). Python kurulu olmasa bile ilk çağrıda taşınabilir gömülü runtime otomatik iner.',
-          'PYTHON DURUMU: makinede sistem Python\'u görünmese bile ŞAŞIRMA ve "python yok" DEME — python_run aracı kendi taşınabilir runtime\'ını (%APPDATA%\\beast\\py\\python.exe) otomatik indirir/kullanır ve bu klasör run_command PATH\'inde önceliklidir; yani run_command içinde de `python` çalışır. Ham Google/Bing scrape yerine önce web_search aracını kullan (zaten Python çoklu-motor + Exa destekli), script gerektiğinde python_run yaz.',
+            'PYTHON DURUMU: makinede sistem Python\'u görünmese bile ŞAŞIRMA ve "python yok" DEME — python_run aracı kendi taşınabilir runtime\'ını (%APPDATA%\\beast\\py\\python.exe) otomatik indirir/kullanır ve bu klasör run_command PATH\'inde önceliklidir; yani run_command içinde de `python` çalışır. Ham Google/Bing scrape yerine önce web_search aracını kullan (zaten Obscura stealth tarayıcı + TinyFish + Python çoklu-motor destekli), script gerektiğinde python_run yaz.',
           'PDF ÇIKTI KURALI: PDF üretirken pip\u2019ten pdf paketi (fpdf, fpdf2, markdown-pdf, weasyprint, reportlab vb.) KURMA/KULLANMA — bunlar Türkçe karakterleri bozar. Doğru kit Node tarafında ZATEN kurulu: `pdf-lib` + `@pdf-lib/fontkit` (Türkçe font gömme) ve `pdfkit`. python_run ile DEĞİL; write_file ile .js script yazıp run_command ile `node script.js` çalıştır. md→pdf çevirici YOKTUR ve kurulmaz: kullanıcıya rapor/özet/belge çıktısı vereceksen .md dosyası gönderme — aynı içeriği DOĞRUDAN pdf-lib/pdfkit ile PDF olarak üret ve send_file ile o PDF\u2019i gönder. Ayrıntılı örnekler: pdf skill\u2019i (SKILL.md).',
           'Eski bir hafıza kaydına ihtiyacın olursa memory_search ile ara; kalıcı bilgi/birikim için kb_search kullan, yeni bilgi öğrenirsen kb_add ile kaynak belirt.',
           'Bir oturumda 3+ kez memory_write yaptıysan iş bitince memory_hygiene çağır (duplike/eskime temizliği).',
@@ -1332,7 +1338,8 @@ class Engine {
             'Görev tanımı kendi başına YETERLİ olsun: tüm bağlam, dosya/URL yolları, kısıtlar ve beklenen çıktı görev metnine yazılır — paralel ajan senin bağlamını göremez.',
             'Birden fazla bağımsız iş varsa hepsini aynı anda ayrı run_background çağrılarıyla devret (paralel çalışsınlar).',
             'HIZ FAN-OUT: aynı işin farklı adımlarını run_background_many ile TEK SEFERDE paralel aç (örnek: haber taraması → TR / Dünya / Ekonomi ayrı ajan; araştırma+veri çekme+analiz ayrı ajan). Hepsi bitince sana TEK birleşik rapor düşer — hız dramatik artar. Bağımsız 2+ adım görürsen bunu tercih et.',
-            'Takip araçları: tasks_list (genel tablo), task_status (tek ajanın canlı dökümü), task_cancel (iptal). Kullanıcı ilerleme sorarsa buradan raporla.',
+            'Takip araçları: tasks_list (genel tablo), task_status (tek ajanın canlı dökümü), task_cancel (iptal — reason ZORUNLU). Kullanıcı ilerleme sorarsa buradan raporla.',
+            'İPTAL DİSİPLİNİ: bir paralel ajanı task_cancel ile iptal edersen ya da bir işi yarıda bırakırsan, kullanıcıya TEK CÜMLEyle MUTLAKA SEBEBİNİ yaz (neden iptal ettin, ne kayboldu, yerine ne yapacaksın). Sebepsiz iptal YASAK.',
             'Bilgi sorularını, sohbeti, planlamayı, hafıza/hatırlatıcı/izleyici kurulumunu YİNE SEN yaparsın — bunlar "iş" değildir.',
           ].join('\n')
       );
@@ -1611,6 +1618,38 @@ class Engine {
     return true;
   }
 
+  /* SESSİZ BAĞLAM ENJEKSİYONU: metin oturum geçmişine düşer ama _run()
+     TETİKLENMEZ — ajan "görür", cevap ÜRETMEZ. WhatsApp gruplarında
+     @mention moduyla kullanılır: grubun tüm konuşması bağlam olarak
+     birikir, bot yalnız mention gelince konuşur. Ardışık bağlam
+     mesajları işaret önekli tek user mesajında birleşir (bazı sağlayıcılar
+     art arda user mesajını reddettiği için). */
+  observe(sessionId, text) {
+    const s = this._load(String(sessionId));
+    if (!s) return false;
+    const body = String(text || '').slice(0, USER_MAX);
+    if (!body.trim()) return false;
+    const lastMsg = s.messages[s.messages.length - 1];
+    if (
+      lastMsg && lastMsg.role === 'user' &&
+      typeof lastMsg.content === 'string' &&
+      lastMsg.content.startsWith(OBSERVE_MARK)
+    ) {
+      /* önceki bağlam mesajının devamı — tek mesajda birleştir */
+      lastMsg.content = (lastMsg.content + '\n' + body).slice(0, USER_MAX);
+      this._rewriteLastMsg(s.id, lastMsg.content);
+    } else {
+      const msg = { role: 'user', content: body };
+      s.messages.push(msg);
+      try {
+        this._append(s, msg);
+      } catch {}
+    }
+    this.emit({ type: 'observe', sessionId: s.id });
+    this.emit({ type: 'sessions' });
+    return true;
+  }
+
   /* #14 paralel ajanlar: ANA oturumu hiç bloklamayan arka plan çalıştırıcı.
      Ayrı gizli oturum açar, işi orada koşturur; bitince özet bildirim
      istenen sohbete düşer. Birden fazla iş aynı anda paralel koşabilir —
@@ -1812,7 +1851,7 @@ class Engine {
         if (j.status === 'running' || j.status === 'queued') {
           j.status = 'aborted';
           j.endedAt = new Date().toISOString();
-          j.error = String(j.error || '') || 'uygulama kapatıldı';
+          j.error = String(j.error || '') || 'uygulama kapatıldı — paralel ajan yarıda kesildi';
           migrated = true;
         }
         j._persisted = true;
@@ -1905,9 +1944,18 @@ class Engine {
       this._pendingReports = this._pendingReports || [];
       this._pendingReports.push({ parentId: job.parentId, text });
       this.flushPendingReports(job.parentId);
-    } else if (status === 'aborted' && grouped) {
-      /* iptal edilen üye gruptan düşmüş sayılır */
-      this._bgGroupRecord(job.title, 'aborted', '');
+    } else if (status === 'aborted') {
+      /* İPTAL SEBEBİ ZORUNLU: sebebi kayda yaz ve üst sohbete/gruba bildir */
+      const why = String(errorMsg || job.error || 'sebep belirtilmedi').slice(0, 300);
+      if (grouped) {
+        /* iptal edilen üye gruptan düşmüş sayılır — birleşik raporda SEBEPİYLE görünür */
+        this._bgGroupRecord(job.title, 'aborted', 'İPTAL: ' + why);
+      } else {
+        const text = `[ARKA PLAN İPTAL: ${job.title}]\nSebep: ${why}`;
+        this._pendingReports = this._pendingReports || [];
+        this._pendingReports.push({ parentId: job.parentId, text });
+        this.flushPendingReports(job.parentId);
+      }
     }
   }
 
@@ -2397,8 +2445,21 @@ class Engine {
       const aborted = e && (e.name === 'AbortError' || ctrl.signal.aborted);
       if (aborted) {
         this._clearCrash(); // kullanıcı durdurdu — kurtarma yok
-        emit({ type: 'done', aborted: true });
-        this._bgFinish(sid, 'aborted');
+        /* öz-kurtarma/superyorizon kick'i bekliyorsa bu tur BİTİŞ değildir —
+           işi aborted KAPATMA, kick mesajı yeni turu açar */
+        const kickJob = this._bgJobs && this._bgJobs.get(sid);
+        if (kickJob && kickJob.revive === true) {
+          emit({ type: 'done', aborted: true });
+        } else {
+          /* İPTAL SEBEBİ ZORUNLU: interrupt() tarafından kaydedilir */
+          const why =
+            (this._abortReasons && this._abortReasons.get(sid)) ||
+            (kickJob && kickJob.error) ||
+            'kullanıcı talebiyle iptal edildi';
+          if (this._abortReasons) this._abortReasons.delete(sid);
+          emit({ type: 'done', aborted: true, reason: why });
+          this._bgFinish(sid, 'aborted', why);
+        }
       } else {
         // FALLOUT: tüm zincir tükendi — durumu kaydet, açılışta kaldığı yerden devam edilir
         this._saveCrash(sid, e, 'chain-exhausted');
@@ -2641,7 +2702,7 @@ class Engine {
       if (!this.ctrls.has(pairId)) break;
     }
     if (this.ctrls.has(pairId)) {
-      try { this.interrupt(pairId); } catch {}
+      try { this.interrupt(pairId, 'bot DM zaman aşımına uğradı (120 sn) — tur kesildi'); } catch {}
       return { ok: false, error: 'hedef bot zaman aşımına uğradı (120 sn)' };
     }
     const after = this.cache.get(pairId) || pair;
@@ -2755,39 +2816,19 @@ class Engine {
     }
   }
 
-  /* web_search zinciri — web_search VE deep_search aynı zinciri kullanır:
-     1) dahili tarayıcı (DİREK GOOGLE — ücretsiz + AI cevabı)
-     2) TinyFish (tarayıcı sorun çıkarsa HEMEN devreye girer — anahtar girildiyse)
-     3) python çoklu-motor (ddgs / DDG+Bing+Mojeek)
-     4) Exa (anahtar girildiyse, son çare)
-     Tarayıcıda CAPTCHA/"olağandışı trafik"/boş sonuç algılanırsa 10 dk boyunca
-     tarayıcı ATLANIR — her arama TinyFish'ten başlar, süre dolunca tarayıcı geri döner. */
-  async _webSearchChain(q, n, sessionId, signal) {
-    let r = null;
-    let banned = false;
+  /* web_search zinciri — web_search VE deep_search aynı zinciri kullanır.
+     Sıra + aç/kapa Ayarlar → Web Arama'dan değiştirilir (tools.searchChainWeb):
+     varsayılan: 1) dahili tarayıcı (DİREK GOOGLE) 2) Obscura (stealth headless
+     → DuckDuckGo; otomatik kurulur, varsayılan AKTİF) 3) TinyFish (anahtar
+     girildiyse) 4) python çoklu-motor. Tarayıcı CAPTCHA/trafik verirse 10 dk
+     atlanır — sıradaki motor hemen devreye girer. */
+  _webSearchChain(q, n, sessionId, signal) {
     const browserUsable = this.browser && typeof this.browser.search === 'function';
-    if (Date.now() < (this._webSearchBrowserBanUntil || 0)) banned = true;
-    if (browserUsable && !banned) {
-      try { r = await this.browser.search(q, signal, { sessionId }); } catch {}
-      if (!r || !r.ok || !(r.results || []).length) {
-        /* tarayıcı sorunlu — 10 dk atla, alternatif zincir hemen devrede */
-        this._webSearchBrowserBanUntil = Date.now() + 10 * 60 * 1000;
-        r = null;
-        banned = true;
-      }
-    }
-    if (!r || !r.ok || !(r.results || []).length) {
-      try { r = await tools.tinyfishSearch(q, n, signal); } catch {}
-    }
-    if (!r || !r.ok || !(r.results || []).length) {
-      try {
-        r = JSON.parse(await tools.exec('web_search', { query: q, max_results: n }, { cwd: this._sessionWorkspace(sessionId), signal }));
-      } catch {}
-    }
-    const out = r || { ok: false, error: 'web arama başarısız — tüm motorlar boş döndü' };
-    if (out && out.ok && banned) out.note = 'tarayıcı araması 10 dk askıda (CAPTCHA/trafik) — TinyFish/alternatif zincir kullanıldı';
-    return out;
-  }
+    return tools.searchChainWeb(q, n, {
+      signal,
+      browser: browserUsable ? () => this.browser.search(q, signal, { sessionId }) : null,
+    });
+  }
 
   /* Dahili OCR aracı: görüntüden metin çıkarır (görsel desteklemeyen modeller için).
      Kaynak: 'browser' (dahili tarayıcı görüntüsü, varsayılan) | 'screen' (masaüstü) | dosya yolu. */
@@ -3016,8 +3057,11 @@ class Engine {
       }
       if (name === 'task_cancel') {
         const id = String(args.id || '');
-        const ok = this.interrupt(id);
-        return JSON.stringify(ok ? { ok: true, id } : { ok: false, error: 'çalışan ajan yok: ' + id });
+        const why = String(args.reason || '').trim() || 'ana ajan (CEO) bu ajanı task_cancel ile iptal etti';
+        const ok = this.interrupt(id, why);
+        return JSON.stringify(ok
+          ? { ok: true, id, reason: why, note: 'Ajan iptal edildi — kullanıcıya MUTLAKA iptal sebebini tek cümleyle açıkla: ' + why }
+          : { ok: false, error: 'çalışan ajan yok: ' + id });
       }
       if (name === 'set_reminder') {
         if (!this.reminders || typeof this.reminders.add !== 'function') {
@@ -3139,10 +3183,8 @@ class Engine {
       }
       if (name === 'deep_search') {
         /* agentic derin araştırma: çoklu sorgu + gizli tarayıcıda sayfa okuma.
-           ARAMA zinciri web_search ile BİREBİR AYNI — eski sürüm yalnız python
-           motorlarını (ddgs/DDG/Bing) kullanıyordu; CAPTCHA/engel sonucu motorlar
-           boş dönünce "tüm motorlar boş döndü" hatası veriyordu. Artık önce
-           DAHİLİ TARAYICI (Google) denenir, sonra TinyFish → python → Exa. */
+           ARAMA zinciri web_search ile BİREBİR AYNI — sıralı zincir
+           (tarayıcı → Obscura → TinyFish → python; Ayarlar'dan değiştirilir). */
         try {
           emitSafe(this, sessionId, { type: 'status', status: 'derin araştırma: çoklu sorgu + gizli sayfa okuma' });
         } catch {}
@@ -3207,9 +3249,34 @@ class Engine {
     }
   }
 
-  interrupt(sessionId) {
-    const c = this.ctrls.get(String(sessionId));
-    if (!c) return false;
+  /* İptal SEBEBİ zorunlu: abort edilen her tur/_bgFinish bu haritadan sebebini
+     okur; ajan neden durdurulduğunu kullanıcıya MUTLAKA bildirir. */
+  _abortReason(reason) {
+    const r = String(reason || '').trim();
+    return (r || 'sebep belirtilmedi — iptal talebi').slice(0, 400);
+  }
+
+  interrupt(sessionId, reason) {
+    const sid = String(sessionId || '');
+    const why = this._abortReason(reason);
+    const c = this.ctrls.get(sid);
+    if (!c) {
+      /* koşan tur yok — kuyrukta bekleyen / öz-kurtarma kick'i bekleyen
+         paralel ajanı da SEBEPİYLE kes */
+      const j = this._bgJobs && this._bgJobs.get(sid);
+      if (j && (j.status === 'queued' || j.revive === true)) {
+        j.status = 'aborted';
+        j.revive = false;
+        j.endedAt = nowIso();
+        j.error = why;
+        this._clearKicks(sid);
+        this._bgEmit();
+        return true;
+      }
+      return false;
+    }
+    this._abortReasons = this._abortReasons || new Map();
+    this._abortReasons.set(sid, why);
     c.abort();
     return true;
   }
@@ -3219,19 +3286,22 @@ class Engine {
      main katmanında BAĞIMSIZ yaşar — /stop onlara dokunmaz. */
   stopAll() {
     let aborted = 0;
+    const why = '/stop: kullanıcı tüm ajanları ve turları durdurdu';
     /* fan-out gruplarını kapat — yarım grup artık birleşik rapor beklemesin */
     if (this._bgGroups) {
       for (const g of this._bgGroups.values()) g.dead = true;
     }
     if (this._bgPendingStart) this._bgPendingStart.clear();
+    this._abortReasons = this._abortReasons || new Map();
     for (const [sid, c] of this.ctrls) {
-      try { c.abort(); aborted++; } catch {}
+      try { this._abortReasons.set(sid, why); c.abort(); aborted++; } catch {}
       /* abort sonrası _run finally bloğu temizler; paralel ajan kaydını biz işaretleyelim */
       if (this._bgJobs.has(sid)) {
         const job = this._bgJobs.get(sid);
         if (job.status === 'running' || job.status === 'queued') {
           job.status = 'aborted';
           job.endedAt = nowIso();
+          job.error = job.error || why;
         }
         job.revive = false; // bekleyen öz-kurtarma gönderimini de öldür
         this._clearKicks(sid);
@@ -3242,6 +3312,7 @@ class Engine {
       if (j.status === 'queued') {
         j.status = 'aborted';
         j.endedAt = nowIso();
+        j.error = j.error || why;
         aborted++;
       }
     }
@@ -3613,13 +3684,15 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'task_cancel',
-      description: 'Cancel a running background agent by id (from tasks_list).',
+      description:
+        'Cancel a running background agent by id (from tasks_list). ALWAYS pass reason: a short sentence explaining WHY you are cancelling — it is recorded on the job and you must report it to the user.',
       parameters: {
         type: 'object',
         properties: {
           id: { type: 'string' },
+          reason: { type: 'string', description: 'REQUIRED: why you are cancelling this agent (one short sentence)' },
         },
-        required: ['id'],
+        required: ['id', 'reason'],
       },
     },
   },
@@ -3850,3 +3923,4 @@ module.exports.BG_HIDDEN_TOOLS = BG_HIDDEN_TOOLS;
 module.exports.PERM_TOOL_SETS = PERM_TOOL_SETS;
 module.exports.PERM_LEVELS = PERM_LEVELS;
 module.exports.normalizePerms = normalizePerms;
+module.exports.OBSERVE_MARK = OBSERVE_MARK;

package/src/agent/obscura.js

@@ -0,0 +1,245 @@
+'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;
+
+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) {
+  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));
+      }
+      if (res.statusCode !== 200) {
+        res.resume();
+        return reject(new Error(`indirme başarısız: HTTP ${res.statusCode}`));
+      }
+      const chunks = [];
+      let size = 0;
+      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);
+      });
+      res.on('end', () => 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) */
+async function installObscura(signal) {
+  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);
+  fs.writeFileSync(zipPath, buf);
+  const ok = await psExpand(zipPath, dest);
+  try { fs.unlinkSync(zipPath); } catch {}
+  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();
+  return { ok: good, dir: dest, error: good ? null : 'obscura.exe doğrulanamadı' };
+}
+
+/* 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.`,
   },