beast-agent 0.25.2 → 0.25.4

package/bin/beast-agent.js

@@ -82,27 +82,44 @@ if (process.argv[2] === 'update') {
     process.exit(1);
   }
   console.log('\n\u2713 beast-agent g\u00FCncellendi \u2014 uygulama ba\u015Flat\u0131l\u0131yor\u2026');
-  try {
-    const electron = require('electron');
-    if (typeof electron === 'string') {
-      spawn(electron, [path.resolve(__dirname, '..')], { stdio: 'ignore', detached: true }).unref();
-    }
-  } catch {}
+  launchDetached([]);
   if (isWin) spawnSync('cmd.exe', ['/c', 'timeout /t 3'], { stdio: 'ignore' });
   process.exit(0);
 }
 
-const electron = require('electron');
-if (typeof electron !== 'string') {
-  /* electron runtime içindeyiz — bu script için anlamsız */
-  process.exit(1);
+/* detached başlatıcı + kendini onaran electron:
+   taze makinalarda npm postinstall sırasında electron binary indirmesi
+   sessizce başarısız olmuş olabilir → burada otomatik tamir edilir. */
+function launchDetached(extraArgs) {
+  let electron = null;
+  try { electron = require('electron'); } catch {}
+  if (typeof electron !== 'string') {
+    let fix = null;
+    try { fix = require('../scripts/fix-electron'); } catch {}
+    if (fix) {
+      console.log('\u27F3 electron \u00e7al\u0131\u015Fma dosyalar\u0131 eksik bulundu \u2014 otomatik onar\u0131l\u0131yor\u2026');
+      const r = fix.repair({ quiet: false });
+      if (r.ok && !r.skipped) console.log('\u2713 electron onar\u0131ld\u0131');
+      if (r.ok) {
+        try { electron = require('electron'); } catch {}
+      }
+    }
+  }
+  if (typeof electron !== 'string') {
+    console.log('\n\u2717 Electron \u00e7al\u0131\u015Fma dosyas\u0131 kurulamad\u0131.');
+    console.log('  Elle \u00e7\u00f6z\u00fcm \u2014 \u015fu 2 komutu \u00e7al\u0131\u015Ft\u0131r:');
+    console.log('    npm config set ignore-scripts false');
+    console.log('    npm install -g beast-agent');
+    return false;
+  }
+  const child = spawn(electron, [path.resolve(__dirname, '..'), ...extraArgs], {
+    stdio: 'ignore',
+    detached: true,
+    /* windowsHide KULLANMA: Chromium ilk pencereyi gizli başlatıyor (tray-only bug) */
+  });
+  child.unref();
+  return true;
 }
 
-const appPath = path.resolve(__dirname, '..');
-const child = spawn(electron, [appPath, ...process.argv.slice(2)], {
-  stdio: 'ignore',
-  detached: true,
-  /* windowsHide KULLANMA: Chromium ilk pencereyi gizli başlatıyor (tray-only bug) */
-});
-child.unref();
+if (!launchDetached(process.argv.slice(2))) process.exit(1);
 process.exit(0);

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "beast-agent",
     "productName": "Beast Agent",
-    "version": "0.25.2",
+    "version": "0.25.4",
     "description": "Ultra-fast local agent shell for Windows.",
     "author": "algokodcom (AlgoKod)",
     "license": "MIT",
@@ -33,6 +33,7 @@
         "dist": "electron-builder --win nsis portable",
         "test": "node --test \"tests/**/*.test.js\"",
         "release": "node scripts/release.js",
+        "postinstall": "node scripts/fix-electron.js --soft",
         "prepublishOnly": "node scripts/swap-electron.js deps",
         "postpublish": "node scripts/swap-electron.js devdeps"
     },

package/scripts/fix-electron.js

@@ -0,0 +1,126 @@
+'use strict';
+
+/* BEAST — electron binary onarıcı.
+   SORUN: `electron` npm paketi binary'yi (dist/electron.exe) postinstall'da
+   GitHub'dan indirir. Taze makinalarda bu indirme SESSİZCE başarısız olabilir
+   (proxy/GitHub engeli, npm ignore-scripts=true, ağ kesintisi) — paket kurulmuş
+   görünür ama `require('electron')` "Electron failed to install correctly" fırlatır.
+   ÇÖZÜM: install.js'i elle çalıştır; olmazsa yedek aynadan (npmmirror) dene.
+   Kullanım yerleri:
+     - package.json postinstall  → kurulumda otomatik (npm i -g beast-agent)
+     - bin/beast-agent.js        → her başlatmada bozuksa otomatik onar */
+
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+/* electron paket dizini (index.js'in yeri); paket hiç yoksa null */
+function electronDir() {
+  try {
+    return path.dirname(require.resolve('electron'));
+  } catch {
+    return null;
+  }
+}
+
+/* binary sağlam mı? electron/index.js'in beklentisiyle aynı kontrol:
+   path.txt + dist/<exe> varlığı */
+function status() {
+  const dir = electronDir();
+  if (!dir) return { ok: false, missing: true };
+  const exe = process.platform === 'win32' ? 'electron.exe' : 'electron';
+  const distOk = fs.existsSync(path.join(dir, 'dist', exe));
+  const txtOk = fs.existsSync(path.join(dir, 'path.txt'));
+  return distOk && txtOk ? { ok: true, dir } : { ok: false, dir };
+}
+
+/* platforma göre dist içindeki çalıştırılabilirin göreli yolu (electron/index.js ile aynı) */
+function platformPath() {
+  switch (process.platform) {
+    case 'win32':
+      return 'electron.exe';
+    case 'darwin':
+    case 'mas':
+      return 'Electron.app/Contents/MacOS/Electron';
+    default:
+      return 'electron';
+  }
+}
+
+/* onarım — 3 katman:
+   0) binary sağlam, yalnız path.txt eksik/bozuk → indirimsiz anında yazar
+      (install.js bu durumu "zaten kurulu" sanıp atlayabiliyor)
+   1) dist bozuk/eksik → dist'i sil + install.js (GitHub) ile taze indir
+   2) GitHub engelli → ELECTRON_MIRROR=npmmirror ile tekrar */
+function repair({ quiet } = {}) {
+  let st = status();
+  if (st.ok) return { ok: true, dir: st.dir, skipped: true };
+  if (st.missing) return { ok: false, error: 'electron paketi hi\u00e7 yok — npm install -g beast-agent' };
+  const dir = st.dir;
+  const exeRel = platformPath();
+  const exeAbs = path.join(dir, 'dist', ...exeRel.split('/'));
+  const verFile = path.join(dir, 'dist', 'version');
+  let wantVer = null;
+  try { wantVer = String(require(path.join(dir, 'package.json')).version || ''); } catch {}
+  const distIntact =
+    fs.existsSync(exeAbs) &&
+    (!wantVer ||
+      (fs.existsSync(verFile) &&
+        fs.readFileSync(verFile, 'utf8').replace(/^v/, '').trim() === wantVer));
+
+  if (distIntact) {
+    /* KATMAN 0: hızlı onarım — path.txt'yi kendimiz yazıyoruz (indirim yok) */
+    try { fs.writeFileSync(path.join(dir, 'path.txt'), exeRel, 'utf8'); } catch {}
+    if (status().ok) return { ok: true, dir, fast: true };
+  }
+
+  /* KATMAN 1-2: tam indirim */
+  try { fs.rmSync(path.join(dir, 'dist'), { recursive: true, force: true }); } catch {}
+  try { fs.unlinkSync(path.join(dir, 'path.txt')); } catch {}
+  const installJs = path.join(dir, 'install.js');
+  if (!fs.existsSync(installJs)) {
+    return { ok: false, error: 'install.js yok — yeniden kur: npm install -g beast-agent' };
+  }
+
+  const sources = [null, 'https://npmmirror.com/mirrors/electron/'];
+  for (let i = 0; i < sources.length; i++) {
+    const env = { ...process.env };
+    if (sources[i]) {
+      env.ELECTRON_MIRROR = sources[i];
+      if (!quiet) console.log('  \u2022 varsay\u0131lan kaynak ba\u015Far\u0131s\u0131z \u2014 yedek ayna deneniyor (npmmirror)\u2026');
+    } else if (!quiet) {
+      console.log('  \u2022 electron binary indiriliyor (ilk sefer ~110 MB, 1-2 dk)\u2026');
+    }
+    const r = spawnSync(process.execPath, [installJs], {
+      cwd: dir,
+      env,
+      stdio: quiet ? 'ignore' : 'inherit',
+      timeout: 600000,
+    });
+    if (!r.error && r.status === 0 && status().ok) {
+      return { ok: true, dir, mirror: sources[i] || 'github' };
+    }
+    if (!quiet && r.error) {
+      console.log('  ! deneme ba\u015far\u0131s\u0131z: ' + String(r.error.message || r.error).slice(0, 160));
+    }
+  }
+  return { ok: false, error: 'electron binary indirilemedi (a\u011f/proxy engeli olabilir)' };
+}
+
+module.exports = { electronDir, status, repair };
+
+/* CLI: package.json postinstall → `node scripts/fix-electron.js --soft`
+   (her durumda exit 0 — npm install bozulmasın, başlatma anında tekrar denenir)
+   elle çağrı → hata durumunda exit 1 */
+if (require.main === module) {
+  const soft = process.argv.includes('--soft');
+  const r = repair({ quiet: false });
+  if (r.ok) {
+    console.log(r.skipped ? '\u2713 electron binary tamam' : '\u2713 electron binary onar\u0131ld\u0131');
+    process.exit(0);
+  }
+  console.error('\u2717 electron onar\u0131lamad\u0131: ' + (r.error || '?'));
+  console.error('  elle \u00e7\u00f6z\u00fcm: npm config set ignore-scripts false');
+  console.error('           npm install -g beast-agent');
+  process.exit(soft ? 0 : 1);
+}

package/src/agent/engine.js

@@ -69,13 +69,13 @@ const FORMAT_RULES =
 const PERM_TOOL_SETS = {
   all: null, // tüm araçlar (filtre yok)
   web: new Set([
-    'web_search', 'http_fetch',
+    'web_search', 'http_fetch', 'deep_search',
     'browser_open', 'browser_read', 'browser_snapshot', 'browser_screenshot',
     'browser_click', 'browser_type', 'browser_press', 'browser_scroll', 'browser_select',
     'ocr_read',
   ]),
   read: new Set([
-    'web_search', 'http_fetch',
+    'web_search', 'http_fetch', 'deep_search',
     'browser_open', 'browser_read', 'browser_snapshot',
     'list_dir', 'read_file',
   ]),
@@ -99,7 +99,7 @@ function normalizePerms(p) {
 const CEO_EXEC_TOOLS = new Set([
   'run_command', 'read_file', 'write_file', 'list_dir',
   'python_run',
-  'web_search', 'http_fetch',
+  'web_search', 'http_fetch', 'deep_search',
   'browser_open', 'browser_read', 'browser_screenshot', 'browser_snapshot',
   'browser_click', 'browser_type', 'browser_press', 'browser_scroll', 'browser_select',
   'computer_look', 'computer_act',
@@ -1290,6 +1290,7 @@ class Engine {
             ? 'Bağımsız alt-işleri run_background ile PARALEL ajana devret; işi KENDİN YÜRÜTME — emri ver, takip et, raporla.'
             : 'Bağımsız alt-işleri delegate_task ile devret; kendi başına halledebileceğin işleri devretme.',
           'Güncel/dış bilgi gerekiyorsa web_search kullan (zincir DAHİLİ tarayıcıyla başlar — gerçek Chromium ile Google); hızlı ham metin okuması için http_fetch kullan.',
+          'DERİN ARAŞTIRMA: web_search\u2019in sonucu yetersizse/istenen bilgi listede YOKSA aramayı tekrar tekrar deneme yerine deep_search kullan — 1-4 sorgu varyantını (eş anlamlı, Türkçe+İngilizce yazımlar) PARALEL aratır ve ilk sayfaları GİZLİ gerçek Chromium\u2019da açıp tam metin okur (paneli açmaz, kullanıcıyı rahatsız etmez; JS/SPA sayfalar çalışır). Fiyat karşılaştırma, çok kaynaklı araştırma, "her şeyi bul" işleri ve Türkçe sorgularda sonuç zayıfsa doğrudan deep_search seç. read_top=0 verirsen yalnız harmanlanmış sonuç listesi döner.',
           'ARAMA-DİSİPLİN: bir bilgiyi 2-3 denemede bulamazsan TAKILMA — farklı bir açıya/sorguya geç, yine yoksa bulabildiğin kısmi bilgiyle cevap ver ve neyi bulamadığını açıkça söyle. Kapalı/gizli içerik (private profil, login arkası veri) peşinde KOŞMA — bulunamayacağı belliyse hemen vazgeç.',
           'TARAYICI VARSAYILANI (ZORUNLU): kullanıcı "şu siteyi aç", "bunu ara / google\u2019da ara", "şu sayfaya git" gibi bir web isteği verdiğinde HEP DAHİLİ TARAYICIYI KULLAN (browser_open ile aç → açılış yanıtında hazır snapshot gelir → ref numaralarıyla browser_click/browser_type/browser_select ile hareket et; HER eylem yanıtında taze snapshot döner — ayrıca browser_snapshot çağırma, yanıttaki refleri kullan; browser_read ile metin oku; sadece görsel yerleşim/grafik gerekiyorsa browser_screenshot çek). Tarih/saat alanlarını (type=date/time) browser_type ile DÜZ METİN yaz ("15.03.2026", "2026-03-15") — takvimden tıklamaya çalışma, alan programatik ayarlanır. Panel ekranın sağında açılır ve kullanıcı da sayfayı anında görür; JS/login/SPA/dinamik içerik için idealdir. Bu kural TÜM oturumları kapsar — masaüstü sohbeti ve çok kullanıcılı botlar (WhatsApp vb.) dahil.' +
             ' DIŞ TARAYICI İSTİSNASI: kullanıcı AÇIKÇA "chrome\u2019da aç", "firefox\u2019ta aç", "başka tarayıcıda aç", "normal tarayıcıda aç", "kendi tarayıcımda aç" derse O ZAMAN run_command ile `start "" <url>` çalıştır — sistem varsayılan (dış) tarayıcısında açılır. Kullanıcı dış tarayıcı istemedikçe ASLA dış tarayıcı açma.' +
@@ -2113,7 +2114,7 @@ class Engine {
       `Ortam: Windows + PowerShell; çalışma klasörü: ${this.workspace}\n` +
       `HIZ KURALLARI:\n` +
       `- Döngülü işleri (çok URL/dosya/sayfa, tekrarlı parse-hesap) TEK python_run betiğinde topluca bitir.\n` +
-      `- Web için web_search kullan (zincir dahili tarayıcıyla başlar — gerçek Chromium ile Google); sayfa açma/göstermenin VARSAYILANI DAHİLİ tarayıcıdır: browser_open → browser_snapshot → browser_click/type/read. Kullanıcı açıkça dış tarayıcı (chrome/firefox/başka/normal/kendi tarayıcım) istediyse run_command ile \`start "" <url>\` çalıştır. Görseli göremiyorsan metni ocr_read ile oku (source:"browser").\n` +
+      `- Web için web_search kullan (zincir dahili tarayıcıyla başlar — gerçek Chromium ile Google); tek aramada bulunamazsa veya çok kaynaklı derin araştırma gerekiyorsa deep_search kullan (çoklu sorgu paralel + gizli tarayıcıda tam sayfa okuma). Sayfa açma/göstermenin VARSAYILANI DAHİLİ tarayıcıdır: browser_open → browser_snapshot → browser_click/type/read. Kullanıcı açıkça dış tarayıcı (chrome/firefox/başka/normal/kendi tarayıcım) istediyse run_command ile \`start "" <url>\` çalıştır. Görseli göremiyorsan metni ocr_read ile oku (source:"browser").\n` +
       `- Bağımsız araç çağrılarını aynı turda PARALEL ver.\n` +
       `- ARAŞTIRMA SINIRI: 3-5 kaynak yeter; süre hedefi ~3 dakika. 2-3 denemede bulunamayan bilgiyi BIRAK — bulabildiğin kısmi sonucu raporla ve neyi bulamadığını yaz. Kapalı/gizli içerik peşinde koşma.\n` +
       FORMAT_RULES + '\n' +
@@ -2721,7 +2722,7 @@ class Engine {
 
   /* 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. */
-  async _ocrRead(args, signal) {
+  async _ocrRead(args, signal, sessionId) {
     if (!this.ocr) return { ok: false, error: 'OCR kullanılamıyor' };
     const src = String((args && args.source) || 'browser');
     let image = null;
@@ -2732,7 +2733,7 @@ class Engine {
         if (!this.browser || typeof this.browser.screenshot !== 'function') {
           return { ok: false, error: 'dahili tarayıcı kullanılamıyor' };
         }
-        const shot = await this.browser.screenshot(signal);
+        const shot = await this.browser.screenshot(signal, { sessionId });
         if (!shot || !shot.ok) return { ok: false, error: (shot && shot.error) || 'görüntü alınamadı' };
         image = shot.__injectImage || shot.image || null;
       } else if (src === 'screen') {
@@ -3067,6 +3068,17 @@ class Engine {
         const r = await this.computer.act(op, args || {});
         return JSON.stringify(r);
       }
+      if (name === 'deep_search') {
+        /* agentic derin araştırma: çoklu sorgu + gizli tarayıcıda sayfa okuma.
+           Hook (main process) yoksa tools.exec'teki arama-tek yol devreye girer. */
+        try {
+          emitSafe(this, sessionId, { type: 'status', status: 'derin araştırma: çoklu sorgu + gizli sayfa okuma' });
+        } catch {}
+        const run = this.research && typeof this.research.deepSearch === 'function'
+          ? this.research.deepSearch(args || {}, signal)
+          : tools.exec('deep_search', args || {}, { cwd: this._sessionWorkspace(sessionId), signal });
+        return JSON.stringify(await run);
+      }
       if (name === 'web_search') {
         /* SIRA: 1) dahili tarayıcı (DİREK GOOGLE — ücretsiz + AI cevabı)
                  2) TinyFish (tarayıcı sorun çıkarsa HEMEN devreye girer — anahtar girildiyse)
@@ -3081,7 +3093,7 @@ class Engine {
         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); } catch {}
+          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;
@@ -3102,41 +3114,41 @@ class Engine {
         return JSON.stringify(out);
       }
       if (name === 'ocr_read') {
-        return JSON.stringify(await this._ocrRead(args || {}, signal));
+        return JSON.stringify(await this._ocrRead(args || {}, signal, sessionId));
       }
       if (name === 'browser_open') {
         if (!this.browser || typeof this.browser.openUrl !== 'function') {
           return JSON.stringify({ ok: false, error: 'dahili tarayıcı kullanılamıyor' });
         }
-        const r = await this.browser.openUrl(String(args.url || ''), signal);
+        const r = await this.browser.openUrl(String(args.url || ''), signal, { sessionId });
         return JSON.stringify(r);
       }
       if (name === 'browser_read') {
         if (!this.browser || typeof this.browser.readText !== 'function') {
           return JSON.stringify({ ok: false, error: 'dahili tarayıcı kullanılamıyor' });
         }
-        const r = await this.browser.readText(signal);
+        const r = await this.browser.readText(signal, { sessionId });
         return JSON.stringify(r);
       }
       if (name === 'browser_screenshot') {
         if (!this.browser || typeof this.browser.screenshot !== 'function') {
           return JSON.stringify({ ok: false, error: 'dahili tarayıcı kullanılamıyor' });
         }
-        const r = await this.browser.screenshot(signal);
+        const r = await this.browser.screenshot(signal, { sessionId });
         return JSON.stringify(r);
       }
       if (name === 'browser_snapshot') {
         if (!this.browser || typeof this.browser.snapshot !== 'function') {
           return JSON.stringify({ ok: false, error: 'dahili tarayıcı kullanılamıyor' });
         }
-        const r = await this.browser.snapshot(signal);
+        const r = await this.browser.snapshot(signal, { sessionId });
         return JSON.stringify(r);
       }
       if (name === 'browser_click' || name === 'browser_type' || name === 'browser_press' || name === 'browser_scroll' || name === 'browser_select') {
         if (!this.browser || typeof this.browser.act !== 'function') {
           return JSON.stringify({ ok: false, error: 'dahili tarayıcı kullanılamıyor' });
         }
-        const r = await this.browser.act(name.slice(8), args, signal);
+        const r = await this.browser.act(name.slice(8), args, signal, { sessionId });
         return JSON.stringify(r);
       }
       if (!(name === 'run_command' || name === 'read_file' || name === 'write_file' || name === 'list_dir' ||

package/src/agent/research.js

@@ -0,0 +1,133 @@
+'use strict';
+
+/* BEAST — deep_search: agentic araştırma katmanı.
+   web_search snippet'te kalır; bu katman derine iner:
+     1) 1-4 sorgu varyantını PARALEL aratır (toplam süre ≈ tek arama)
+     2) Sonuçları URL bazlı tekilleştirip round-robin harmanlar (kaynak çeşitliliği)
+     3) İlk N sonucu GİZLİ gerçek tarayıcıda açıp tam metin okur
+        (deps.readPage verilmişse; yoksa yalnız sonuç listesi döner)
+   Saf modüldür: search/readPage enjekte edilir — test edilebilir. */
+
+/* İçerik okumada anlamsız/ikili dosyalar — tarayıcıda açmanın anlamı yok */
+const SKIP_FILE_RE = /\.(pdf|docx?|xlsx?|pptx?|zip|rar|7z|exe|dmg|apk|mp[34]|m4a|avi|mkv|webm|jpe?g|png|gif|webp|svg|ico|csv)([?#]|$)/i;
+
+/* URL anahtarı: scheme/www/slash/hash farklarını yok sayar — tekilleştirme için */
+function normKey(u) {
+  try {
+    const x = new URL(u);
+    x.hash = '';
+    let s = x.toString();
+    s = s.replace(/^http:\/\//i, 'https://');
+    s = s.replace(/^https:\/\/www\./i, 'https://');
+    return s.replace(/\/+$/, '').toLowerCase();
+  } catch {
+    return String(u || '').toLowerCase();
+  }
+}
+
+/* search() geri dönüşünü normalize eder: dizi YA DA {results:[...]} kabul;
+   satır anahtarları title/url/snippet VEYA name/href/link/body/description olabilir */
+function normalizeRows(out) {
+  if (!out) return [];
+  const rows = Array.isArray(out) ? out : Array.isArray(out.results) ? out.results : [];
+  return rows
+    .map((r) => ({
+      title: String((r && (r.title || r.name)) || '').replace(/\s+/g, ' ').trim(),
+      url: String((r && (r.url || r.href || r.link)) || '').trim(),
+      snippet: String((r && (r.snippet || r.body || r.description)) || '').replace(/\s+/g, ' ').trim(),
+    }))
+    .filter((r) => r.url && /^https?:\/\//i.test(r.url) && r.title);
+}
+
+/* Liste harmanı: her listenin i. elemanı sırayla alınır (round-robin) —
+   tek motorun sonuçları öne çökmez, kaynak çeşitliliği korunur */
+function mergeResults(lists, limit) {
+  const seen = new Set();
+  const out = [];
+  const max = lists.reduce((m, l) => Math.max(m, l.length), 0);
+  for (let i = 0; i < max && out.length < limit; i++) {
+    for (const list of lists) {
+      if (out.length >= limit) break;
+      const r = list[i];
+      if (!r) continue;
+      const key = normKey(r.url);
+      if (seen.has(key)) continue;
+      seen.add(key);
+      out.push(r);
+    }
+  }
+  return out;
+}
+
+/* Eşzamanlılığı sınırlı paralel map — hata tek elemanı bozar, diziyi bozmaz */
+function mapLimit(items, n, fn) {
+  const out = new Array(items.length);
+  let i = 0;
+  const worker = async () => {
+    while (i < items.length) {
+      const idx = i++;
+      try {
+        out[idx] = await fn(items[idx], idx);
+      } catch (e) {
+        out[idx] = { ok: false, url: items[idx] && items[idx].url, error: String((e && e.message) || e) };
+      }
+    }
+  };
+  const workers = Array.from({ length: Math.max(1, Math.min(n, items.length)) }, worker);
+  return Promise.all(workers).then(() => out);
+}
+
+async function deepSearch(args, deps, signal) {
+  const a = args || {};
+  let queries = a.queries;
+  if (typeof queries === 'string') queries = [queries];
+  if (!Array.isArray(queries) || !queries.length) {
+    const q = String(a.query || '').trim();
+    if (q) queries = [q];
+  }
+  queries = [...new Set((queries || []).map((s) => String(s || '').trim()).filter(Boolean))].slice(0, 4);
+  if (!queries.length) return { ok: false, error: 'sorgu yok — queries: ["...", "..."] ver' };
+  if (signal && signal.aborted) return { ok: false, error: 'iptal edildi', queries };
+
+  const maxResults = Math.max(5, Math.min(25, Number(a.max_results) || 16));
+  const readTop = Math.max(0, Math.min(6, Number(a.read_top != null ? a.read_top : (a.readTop != null ? a.readTop : 3))));
+  const search = deps && typeof deps.search === 'function' ? deps.search : null;
+  if (!search) return { ok: false, error: 'arama altyapısı yok', queries };
+
+  /* 1) paralel arama — bir sorgu çökse diğerleri devam eder */
+  const lists = await Promise.all(
+    queries.map((q) =>
+      Promise.resolve()
+        .then(() => search(q))
+        .then(normalizeRows)
+        .catch(() => [])
+    )
+  );
+  const results = mergeResults(lists, maxResults);
+
+  /* 2) ilk N sonucu gizli tarayıcıda açıp oku (ikili dosyaları atla) */
+  let pages = [];
+  if (readTop && results.length && deps && typeof deps.readPage === 'function') {
+    const targets = results.filter((r) => !SKIP_FILE_RE.test(r.url)).slice(0, readTop);
+    if (targets.length) {
+      pages = (await mapLimit(targets, 2, (r) => deps.readPage(r.url))).filter(Boolean);
+    }
+  }
+  const anyPage = pages.some((p) => p && p.ok);
+
+  return {
+    ok: !!(results.length || anyPage),
+    queries,
+    results,
+    ...(pages.length ? { pages } : {}),
+    ...(results.length || anyPage
+      ? {
+          note: anyPage
+            ? 'sayfalar gizli tarayıcıda açılıp okundu — excerpt\u2019ler pages içinde; bir sayfayı kullanıcıya da göstermek istersen browser_open ile panelde aç'
+            : 'sonuç listesi hazır — tam metin okuma kapalı/başarısız; URL\u2019leri http_fetch ile okuyabilirsin',
+        }
+      : { error: 'tüm motorlar boş döndü — sorguları farklı ifade etmeyi dene' }),
+  };
+}
+
+module.exports = { deepSearch, mergeResults, normalizeRows, normKey, mapLimit, SKIP_FILE_RE };

package/src/agent/tools.js

@@ -6,6 +6,7 @@ const path = require('path');
 const https = require('https');
 const { execFile } = require('child_process');
 const { spawn } = require('child_process');
+const research = require('./research');
 
 const MAX_CMD_OUTPUT = 16000;
 const MAX_FILE_CHARS = 200000;
@@ -647,6 +648,28 @@ const definitions = [
       },
     },
   },
+  {
+    type: 'function',
+    function: {
+      name: 'deep_search',
+      description:
+        'AGENTIC DEEP RESEARCH — use when web_search is not enough or the answer was NOT found on the first try. Runs 1-4 query variants IN PARALLEL (rephrase, synonyms, Turkish + English spellings of the same question), merges + dedupes results, then AUTOMATICALLY opens and reads the top pages with a HIDDEN real-Chromium browser (JS/SPA pages work; the visible panel is NOT touched) and returns full-text excerpts. Ideal for: multi-angle questions (price comparison, reviews, specs, "find everything about X"), Turkish queries that miss results, pages that need JS rendering. Returns {queries, results[{title,url,snippet}], pages[{url,title,content}]}.',
+      parameters: {
+        type: 'object',
+        properties: {
+          queries: {
+            type: 'array',
+            maxItems: 4,
+            items: { type: 'string' },
+            description: '1-4 query variants; e.g. ["iphone 16 fiyat", "iphone 16 price turkey", "iphone 16 technosa"]',
+          },
+          max_results: { type: 'number', description: 'merged result cap, default 16' },
+          read_top: { type: 'number', description: 'how many top results to auto-read fully (0-6, default 3); 0 = results only' },
+        },
+        required: ['queries'],
+      },
+    },
+  },
   {
     type: 'function',
     function: {
@@ -738,6 +761,16 @@ async function exec(name, args, ctx) {
         }
         return JSON.stringify(r);
       }
+      case 'deep_search': {
+        /* hook'suz bağlamda bile çalışsın: yalnız arama zinciri (sayfa okuma yok).
+           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 }) },
+          ctx.signal
+        );
+        return JSON.stringify(r);
+      }
       case 'python_run': {
         const t0 = Date.now();
         /* önce parametreler — interpreter araması gerektirmeyen hatalar erken dönsün */

package/src/agent/watext.js

@@ -36,6 +36,10 @@ const TOOL_LABELS = {
   write_file: (a) => `Dosya yaz: ${a.path || ''}`,
   list_dir: (a) => `Klasör: ${a.path || '.'}`,
   web_search: (a) => `Web arama: ${String(a.query || '').slice(0, 100)}`,
+  deep_search: (a) => {
+    const qs = Array.isArray(a.queries) ? a.queries : [a.query || ''];
+    return `Derin araştırma (${qs.length} sorgu): ${String(qs[0] || '').slice(0, 80)}`;
+  },
   http_fetch: (a) => `Sayfa: ${a.url || ''}`,
   browser_open: (a) => `Tarayıcı aç: ${a.url || ''}`,
   browser_click: (a) => `Tıkla: ${a.ref ?? ''}`,

package/src/main.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const { app, BrowserWindow, WebContentsView, ipcMain, shell, dialog, Tray, Menu, nativeImage, desktopCapturer, session } = require('electron');
+const { app, BrowserWindow, WebContentsView, ipcMain, shell, dialog, Tray, Menu, nativeImage, desktopCapturer, session, net: electronNet } = require('electron');
 const path = require('path');
 const fs = require('fs');
 const http = require('http');
@@ -149,7 +149,8 @@ function startNpmUpdateWatch() {
   check();
   setInterval(check, 6 * 60 * 60 * 1000);
 }
-const { htmlToText, setExaKey, setTinyfishKey } = require('./agent/tools');
+const { htmlToText, setExaKey, setTinyfishKey, webSearchFast } = require('./agent/tools');
+const research = require('./agent/research');
 const { waToolLine } = require('./agent/watext');
 
 /* #3 merkezî log sistemine process-seviye hataları da düşsün */
@@ -1442,7 +1443,7 @@ function botToolSet(cfg) {
     'event_list', 'event_subscribe', 'event_unsubscribe',
     'watcher_add', 'watcher_list', 'watcher_remove',
   ]);
-  if (s.web_search) { set.add('web_search'); set.add('http_fetch'); }
+  if (s.web_search) { set.add('web_search'); set.add('http_fetch'); set.add('deep_search'); }
   if (s.browser) {
     for (const t of ['browser_open', 'browser_read', 'browser_screenshot', 'browser_snapshot', 'browser_click', 'browser_type', 'browser_press', 'browser_scroll', 'browser_select', 'ocr_read']) set.add(t);
   }
@@ -2091,13 +2092,22 @@ function reloadBackend() {
     ocr: (o) => ocrRead(o),
     email: { list: emailList, read: emailRead, send: emailSend },
     browser: {
-      openUrl: (u, s) => browserNavigate(u, s),
-      search: (q, s) => browserSearch(q, s),
+      openUrl: (u, s, ctx) => browserNavigate(u, s, ctx),
+      search: (q, s, ctx) => browserSearch(q, s, ctx),
       readText: (s) => browserRead(s),
       screenshot: (s) => browserScreenshot(s),
       snapshot: (s) => browserSnapshot(s),
       act: (k, a, s) => browserAct(k, a, s),
     },
+    research: {
+      /* deep_search hook'u: çoklu sorgu araması + GİZLİ tarayıcıda tam sayfa okuma.
+         Panel (browser.*) hiç kullanılmaz — kullanıcı ekranı rahatsız edilmez. */
+      deepSearch: (args, signal) =>
+        research.deepSearch(args || {}, {
+          search: (q) => webSearchFast(q, { maxResults: 10, signal }),
+          readPage: (u) => researchRead(u, signal),
+        }, signal),
+    },
     emit: (ev) => {
       if (win && !win.isDestroyed()) win.webContents.send('agent:event', ev);
       flushDesktopOnDone(ev); /* biriken desktop mesajlarını sıraya bas */
@@ -2553,10 +2563,13 @@ function setBrowserOpen(v, forceVisible) {
     return;
   }
 
-  // AÇMA — görünürlük: kullanıcı kendi açtıysa (forceVisible) MUTLAKA görünür;
-  // ajan açtıysa DA VARSAYILAN GÖRÜNÜR (göz ikonuyla gizli mod seçilmedikçe)
+  // AÇMA — görünürlük: forceVisible true/false ise onu uygula;
+  // belirtilmemişse kullanıcı tercihi (settings.browserHeadless) belirler.
+  // PARALEL AJANLAR (bg oturum) her zaman forceVisible=false ile çağırır →
+  // tarayıcı gizli modda çalışır, kullanıcı ekranı ve ajan konsolu rahatsız edilmez.
   browser.open = true;
-  browser.visible = forceVisible === true ? true : settings.browserHeadless !== true;
+  browser.visible =
+    forceVisible === true ? true : forceVisible === false ? false : settings.browserHeadless !== true;
   ensureBrowser();
   if (!browser.started) {
     browser.started = true;
@@ -2585,14 +2598,36 @@ function browserGate(job) {
   __trafficTail = p.catch(() => {});
   return p;
 }
-async function browserNavigate(raw, signal) {
+/* çağıran oturum paralel ajan mı? (run_background ile açılan bg oturumu)
+   → tarayıcıyı GİZLİ kullan: panel ekrana fırlamaz, ajan konsolu kapanmaz */
+function isBgBrowserCtx(ctx) {
+  const sid = ctx && ctx.sessionId ? String(ctx.sessionId) : '';
+  if (!sid) return false;
+  try {
+    return !!(engine && engine._bgJobs && engine._bgJobs.has(sid));
+  } catch {
+    return false;
+  }
+}
+
+/* bg ajan için açma stratejisi: kapalıysa GİZLİ aç; zaten açıksa mevcut
+   görünürlüğe dokunma (kullanıcı paneli izliyorsa aniden saklamayalım) */
+function setBrowserOpenForAgent(ctx) {
+  if (isBgBrowserCtx(ctx)) {
+    if (!browser.open) setBrowserOpen(true, false);
+    return;
+  }
+  setBrowserOpen(true);
+}
+
+async function browserNavigate(raw, signal, ctx) {
   return browserGate(async () => {
     await browserTrafficWait();
-    return browserNavigateNow(raw, signal);
+    return browserNavigateNow(raw, signal, ctx);
   });
 }
 
-async function browserNavigateNow(raw, signal) {
+async function browserNavigateNow(raw, signal, ctx) {
   let url = String(raw || '').trim();
   if (!url) return { ok: false, error: 'boş adres' };
   if (!/^https?:\/\//i.test(url)) {
@@ -2601,7 +2636,7 @@ async function browserNavigateNow(raw, signal) {
       ? 'https://' + url
       : 'https://duckduckgo.com/?q=' + encodeURIComponent(url);
   }
-  setBrowserOpen(true);
+  setBrowserOpenForAgent(ctx);
   const wc = browser.view.webContents;
   await new Promise((resolve) => {
     let settled = false;
@@ -2663,6 +2698,120 @@ function flushBrowserStorage() {
   } catch {}
 }
 
+/* ---------- GİZLİ ARAŞTIRMA TARAYICISI (deep_search) ----------
+   deep_search'ün "sayfayı açıp oku" adımı burada çalışır: WebContentsView
+   HİÇbir pencereye eklenmez (kullanıcı hiçbir şey görmez) ama gerçek Chromium
+   çalışır — JS/SPA sayfalar render olur, innerText okunur. Panel (browser.view)
+   hiç meşgul edilmez. Görsel/font/media indirme hız için iptal edilir.
+   2 slot = en fazla 2 sayfa aynı anda okunur (ayrı view, çakışma yok). */
+const researchPool = { views: [null, null], queue: [], slots: [false, false] };
+const RESEARCH_PAGE_TIMEOUT = 25000;
+const RESEARCH_SETTLE_MS = 900;
+const RESEARCH_CONTENT_CAP = 4500;
+
+function researchAcquire() {
+  return new Promise((resolve) => {
+    researchPool.queue.push(resolve);
+    researchPump();
+  });
+}
+
+function researchRelease(idx) {
+  researchPool.slots[idx] = false;
+  researchPump();
+}
+
+function researchPump() {
+  for (let i = 0; i < researchPool.slots.length; i++) {
+    if (!researchPool.slots[i] && researchPool.queue.length) {
+      researchPool.slots[i] = true;
+      researchPool.queue.shift()(i);
+    }
+  }
+}
+
+function researchViewAt(idx) {
+  let v = researchPool.views[idx];
+  if (v && v.webContents && !v.webContents.isDestroyed()) return v;
+  v = new WebContentsView({
+    webPreferences: {
+      partition: 'research', // kalıcı olmayan bölüm — çerez birikmez
+      contextIsolation: true,
+      nodeIntegration: false,
+      sandbox: true,
+      spellcheck: false,
+      backgroundThrottling: false, // gizli çalışırken zamanlayıcılar yavaşlamasın
+    },
+  });
+  const wc = v.webContents;
+  try {
+    /* Google/bazı siteler Electron UA'yı reddeder — gerçek Chrome kimliği */
+    const chromeUA = `Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/${process.versions.chrome} Safari/537.36`;
+    wc.setUserAgent(chromeUA);
+    const ses = session.fromPartition('research');
+    if (ses && ses.setUserAgent) ses.setUserAgent(chromeUA, 'tr-TR,tr;q=0.9,en;q=0.8');
+  } catch {}
+  try { wc.setWindowOpenHandler(() => ({ action: 'deny' })); } catch {}
+  try {
+    session.fromPartition('research').setPermissionRequestHandler((_w, _p, cb) => cb(false));
+  } catch {}
+  try {
+    /* hız: araştırma okuması için görsel/font/media gereksiz — iptal et */
+    session.fromPartition('research').webRequest.onBeforeRequest({ urls: ['*://*/*'] }, (details, cb) => {
+      cb({ cancel: ['image', 'media', 'font'].includes(details.resourceType) });
+    });
+  } catch {}
+  try {
+    session.fromPartition('research').on('will-download', (_e, item) => { try { item.cancel(); } catch {} });
+  } catch {}
+  wc.on('render-process-gone', () => { researchPool.views[idx] = null; });
+  researchPool.views[idx] = v;
+  return v;
+}
+
+async function researchRead(rawUrl, signal) {
+  const url = String(rawUrl || '').trim();
+  if (!/^https?:\/\//i.test(url)) return { ok: false, url, error: 'geçersiz adres' };
+  if (signal && signal.aborted) return { ok: false, url, error: 'iptal edildi' };
+  const idx = await researchAcquire();
+  try {
+    const view = researchViewAt(idx);
+    if (!view) return { ok: false, url, error: 'araştırma tarayıcısı oluşturulamadı' };
+    const wc = view.webContents;
+    const loaded = await new Promise((resolve) => {
+      let settled = false;
+      const finish = (v) => { if (!settled) { settled = true; clearTimeout(timer); wc.removeListener('did-finish-load', onDone); wc.removeListener('did-fail-load', onFail); resolve(v); } };
+      const timer = setTimeout(() => finish(false), RESEARCH_PAGE_TIMEOUT);
+      const onDone = () => finish(true);
+      const onFail = (_e, code) => { if (code !== -3) finish(false); };
+      wc.once('did-finish-load', onDone);
+      wc.on('did-fail-load', onFail);
+      wc.loadURL(url).catch(() => {});
+    });
+    /* SPA hidrasyonu için kısa settle; metin boşsa bir kez daha dene */
+    await new Promise((r) => setTimeout(r, RESEARCH_SETTLE_MS));
+    let title = '';
+    let finalUrl = url;
+    try { title = wc.getTitle() || ''; finalUrl = wc.getURL() || url; } catch {}
+    const grab = async () => {
+      try { return String((await wc.executeJavaScript('(document.body&&document.body.innerText)||""', true)) || ''); } catch { return ''; }
+    };
+    let text = (await grab()).replace(/\n{3,}/g, '\n\n').trim();
+    if (!text) {
+      await new Promise((r) => setTimeout(r, 1500));
+      text = (await grab()).replace(/\n{3,}/g, '\n\n').trim();
+    }
+    if (!text) {
+      return { ok: false, url: finalUrl, title, error: loaded ? 'sayfa metni boş (tam JS-görsel veya engelli sayfa olabilir)' : 'sayfa yüklenemedi (zaman aşımı/hata)' };
+    }
+    return { ok: true, url: finalUrl, title, truncated: text.length > RESEARCH_CONTENT_CAP, content: text.slice(0, RESEARCH_CONTENT_CAP) };
+  } catch (e) {
+    return { ok: false, url, error: String((e && e.message) || e) };
+  } finally {
+    researchRelease(idx);
+  }
+}
+
 /* Dahili OCR: görsel desteklemeyen modeller için tesseract.js ile metin okuma.
    Dil verisi ilk kullanımda %APPDATA%\beast\tessdata'ya iner, sonra offline çalışır. */
 const _ocrWorkers = new Map(); // lang -> worker (her çağrıda yeniden init olmasın)
@@ -2700,21 +2849,21 @@ async function ocrRead({ image, lang = 'tur+eng' } = {}) {
    Numara: view'i google.com'a bir kez açıp aramaları SAYFA İÇİ fetch() ile
    yapmak (kullanıcının console'da yaptığı gibi) — sayfa bile değişmeden
    DOMParser ile sonuç çekilir. Fetch olmazsa direk gezinme fallback'i var. */
-async function browserSearch(query, signal) {
+async function browserSearch(query, signal, ctx) {
   /* paralel ajan sorguları trafik kapısından sırayla geçer */
   return browserGate(async () => {
     await browserTrafficWait();
-    return browserSearchNow(query, signal);
+    return browserSearchNow(query, signal, ctx);
   });
 }
 
-async function browserSearchNow(query, signal) {
+async function browserSearchNow(query, signal, ctx) {
   try {
     if (!win || win.isDestroyed()) return null;
     if (signal && signal.aborted) return null;
     const q = String(query || '').trim();
     if (!q) return null;
-    setBrowserOpen(true);
+    setBrowserOpenForAgent(ctx);
     const wc = browser.view && browser.view.webContents;
     if (!wc) return null;
 
@@ -3743,13 +3892,21 @@ function flushDesktopOnDone(ev) {
    - Bağlantı geri gelince (DNS kontrolü) sırayla otomatik gönderilir
    - Renderer'a 'net' / 'netQueue' olayları gider: ⏳ kuyruk balonu + toast */
 const NET_CHECK_HOSTS = ['one.one.one.one', 'dns.google'];
+const NET_LOOKUP_HOSTS = ['www.google.com', 'www.microsoft.com'];
+const NET_HTTP_PROBES = [
+  'http://www.msftconnecttest.com/connecttest.txt',
+  'http://cp.cloudflare.com/generate_204',
+  'http://connectivitycheck.gstatic.com/generate_204',
+];
 const NET_CHECK_MS = 8000;
 const NET_CHECK_TIMEOUT = 4000;
+const NET_OFFLINE_STRIKES = 2; // üst üste bu kadar başarısız turda offline ilan edilir
 const CHAT_QUEUE_MAX = 50; // kuyruk üst sınırı — taşarsa en eski düşer
 
 let netOnline = true; // son bilinen bağlantı durumu (başlangıçta iyimser)
 let netCheckedOnce = false;
 let netCheckBusy = false;
+let netFailStreak = 0;
 let chatQueueFlushing = false;
 const chatOfflineQueue = []; // { key, sessionId, text, attachments, at }
 
@@ -3833,8 +3990,42 @@ async function flushChatQueue() {
   }
 }
 
-/* gerçek internet kontrolü: DNS çözümlemesi (sadece ağ arayüzü değil,
-   paket gerçekten çıkıyor mu test eder). Adaylar sırayla denenir. */
+/* gerçek internet kontrolü — TEK yöntem yanıltıcı olabilir:
+   dns.resolve (c-ares) sistem çözümleyicisini atlar; mobil ağ/hotspot/VPN ve
+   ISS DNS engellemelerinde (ör. 1.1.1.1, dns.google) internet VARken bile
+   başarısız çıkar. Bu yüzden katmanlı deniyoruz; HERHANGİ bir katman başarılıysa
+   internet VAR sayılır:
+     1) HTTP connectivity endpoint'leri (http modülü dns.lookup = OS çözümleyicisi
+        kullanır — tarayıcı gibi; captive portal/proxy/mobil ağ hepsinde çalışır)
+     2) dns.lookup (Windows sistem çözümleyicisi — hosts dosyası/VPN/NRPT dahil)
+        + dns.resolve (doğrudan DNS sunucusu)
+     3) OS'in kendi bağlantı durumu (Electron net.isOnline — Windows NCSI)
+   Ayrıca tek başarısız tur offline ilan etmez (2 üst üste başarısız tur gerekir):
+   geçici DNS gecikmesi mesajları gereksiz kuyruğa atmaz. */
+function httpProbe(url) {
+  return new Promise((resolve) => {
+    let done = false;
+    const fin = (v) => { if (!done) { done = true; resolve(v); } };
+    try {
+      const req = http.get(url, { timeout: NET_CHECK_TIMEOUT }, (res) => {
+        res.resume(); // gövdeyi tüket — soket serbest kalsın
+        const ok = !!res.statusCode && res.statusCode < 500;
+        try { res.destroy(); } catch {}
+        fin(ok);
+      });
+      req.on('timeout', () => { try { req.destroy(); } catch {} fin(false); });
+      req.on('error', () => fin(false));
+    } catch { fin(false); }
+  });
+}
+
+function lookupProbe(host) {
+  return new Promise((resolve) => {
+    const t = setTimeout(() => resolve(false), NET_CHECK_TIMEOUT);
+    dns.lookup(host, (err) => { clearTimeout(t); resolve(!err); });
+  });
+}
+
 function dnsProbe(host) {
   return new Promise((resolve) => {
     const t = setTimeout(() => resolve(false), NET_CHECK_TIMEOUT);
@@ -3849,24 +4040,37 @@ async function netCheck() {
   if (netCheckBusy) return;
   netCheckBusy = true;
   try {
-    let ok = false;
-    for (const h of NET_CHECK_HOSTS) {
-      if (await dnsProbe(h)) { ok = true; break; }
+    let ok = (await Promise.all(NET_HTTP_PROBES.map(httpProbe))).some(Boolean);
+    if (!ok) {
+      const lookups = [
+        ...NET_LOOKUP_HOSTS.map(lookupProbe),
+        ...NET_CHECK_HOSTS.map(dnsProbe),
+      ];
+      ok = (await Promise.all(lookups)).some(Boolean);
+    }
+    if (!ok) {
+      try { ok = electronNet.isOnline() === true; } catch {}
     }
     const first = !netCheckedOnce;
     const was = netOnline;
-    netOnline = ok;
     netCheckedOnce = true;
-    if (was !== ok || first) {
+    if (ok) {
+      netFailStreak = 0;
+      netOnline = true;
+    } else {
+      netFailStreak++;
+      if (!was || netFailStreak >= NET_OFFLINE_STRIKES) netOnline = false;
+    }
+    if (netOnline !== was || first) {
       try {
-        if (win && !win.isDestroyed()) win.webContents.send('agent:event', { type: 'net', online: ok });
+        if (win && !win.isDestroyed()) win.webContents.send('agent:event', { type: 'net', online: netOnline });
       } catch {}
-      if (ok) {
+      if (netOnline) {
         log.info('main', 'bağlantı geri geldi — offline kuyruk kontrol ediliyor');
         chatQueueEmit(); // renderer: pill/toast güncellensin
         flushChatQueue().catch(() => {});
       } else {
-        log.info('main', 'internet bağlantısı yok — mesajlar kuyruğa alınacak');
+        log.info('main', `internet bağlantısı yok — mesajlar kuyruğa alınacak (streak=${netFailStreak})`);
         chatQueueEmit();
       }
     }

package/src/renderer/renderer.js

@@ -3395,6 +3395,7 @@ function onEvent(ev) {
     case 'browser': {
       /* visible=false → ajan tarayıcıyı GİZLİ kullanıyor: UI yer açmaz */
       const shown = !!ev.open && ev.visible !== false;
+      const wasShown = document.body.classList.contains('browser-open');
       document.body.classList.toggle('browser-open', shown);
       if (shown && ev.width) document.body.style.setProperty('--bw', ev.width + 'px');
       els.browserBar.hidden = !shown;
@@ -3402,11 +3403,13 @@ function onEvent(ev) {
       /* terminal de sağ dock'u kullanır — tarayıcı açılınca yerini bırak */
       if (shown && termOpen) termSetOpen(false);
       /* #19 tarayıcı açılınca paralel ajan konsolu (sağ panel) yerini bırakır;
-         kapanınca önceki durumuna döner — istenirse railBtn ile elle açılır */
+         kapanınca önceki durumuna döner — istenirse railBtn ile elle açılır.
+         GİZLİ ajan gezinmeleri (shown=false, wasShown=false) rail'e DOKUNMAZ —
+         aksi halde paralel ajan konsolu kendi kendine kapanırdı */
       if (shown) {
         railPrefBeforeBrowser = !document.body.classList.contains('rail-hidden');
         toggleRail(true);
-      } else {
+      } else if (wasShown) {
         toggleRail(!railPrefBeforeBrowser);
       }
       /* IDE modunda tarayıcı açılır/kapanır/genişlik değişirse row yeniden bölünür —

package/tests/research.test.js

@@ -0,0 +1,116 @@
+'use strict';
+
+require('./setup');
+const test = require('node:test');
+const assert = require('node:assert');
+
+const research = require('../src/agent/research');
+
+test('normKey: scheme/www/slash/hash farklarını yok sayar', () => {
+  assert.equal(research.normKey('http://www.Example.com/a/'), research.normKey('https://example.com/a#x'));
+});
+
+test('mergeResults: round-robin harman + tekilleştirme', () => {
+  const a = [
+    { title: 'A1', url: 'https://a.com/1' },
+    { title: 'A2', url: 'https://a.com/2' },
+  ];
+  const b = [
+    { title: 'B1', url: 'https://a.com/1/' }, // A1 ile aynı (slash)
+    { title: 'B1x', url: 'http://www.b.com/x' },
+  ];
+  const merged = research.mergeResults([a, b], 10);
+  assert.deepEqual(merged.map((r) => r.url), ['https://a.com/1', 'https://a.com/2', 'http://www.b.com/x']);
+  assert.equal(merged[2].title, 'B1x'); // ilk gören kazanır, orijinal url korunur
+});
+
+test('normalizeRows: {results} veya dizi + alternatif anahtarlar', () => {
+  const r1 = research.normalizeRows({ results: [{ name: 'X', href: 'https://x.com', body: 'b' }] });
+  assert.equal(r1[0].title, 'X');
+  assert.equal(r1[0].url, 'https://x.com');
+  const r2 = research.normalizeRows([{ title: 'Y', link: 'https://y.com', description: 'd' }]);
+  assert.equal(r2[0].url, 'https://y.com');
+  assert.equal(research.normalizeRows(null).length, 0);
+  assert.equal(research.normalizeRows([{ title: '', url: 'https://z.com' }]).length, 0); // başlıksız elenir
+});
+
+test('deepSearch: paralel sorgular harmanlanır, ilk N sayfa okunur', async () => {
+  const searches = {
+    'elma': [{ title: 'A', url: 'https://a.com' }, { title: 'B', url: 'https://b.com' }],
+    'apple': [{ title: 'B2', url: 'https://b.com' }, { title: 'C', url: 'https://c.com' }],
+  };
+  const readCalls = [];
+  const r = await research.deepSearch(
+    { queries: ['elma', 'apple'], read_top: 2 },
+    {
+      search: async (q) => searches[q],
+      readPage: async (u) => { readCalls.push(u); return { ok: true, url: u, title: 'T:' + u, content: 'icerik ' + u }; },
+    }
+  );
+  assert.ok(r.ok);
+  assert.deepEqual(r.queries, ['elma', 'apple']);
+  assert.equal(r.results.length, 3); // b.com duplike düştü
+  assert.deepEqual(readCalls, ['https://a.com', 'https://b.com']); // ilk 2 hedef
+  assert.equal(r.pages.length, 2);
+  assert.ok(r.pages[0].content.includes('https://a.com'));
+  assert.match(r.note, /gizli tarayıcı/);
+});
+
+test('deepSearch: ikili dosya hedefleri okumadan atlanır', async () => {
+  const readCalls = [];
+  const r = await research.deepSearch(
+    { queries: ['q'], read_top: 3 },
+    {
+      search: async () => [
+        { title: 'PDF', url: 'https://x.com/doc.pdf' },
+        { title: 'Sayfa', url: 'https://x.com/page' },
+      ],
+      readPage: async (u) => { readCalls.push(u); return { ok: true, url: u, content: 'c' }; },
+    }
+  );
+  assert.deepEqual(readCalls, ['https://x.com/page']);
+  assert.equal(r.pages.length, 1);
+});
+
+test('deepSearch: readPage yoksa yalnız sonuç listesiyle döner', async () => {
+  const r = await research.deepSearch(
+    { queries: ['q'] },
+    { search: async () => [{ title: 'A', url: 'https://a.com' }] }
+  );
+  assert.ok(r.ok);
+  assert.equal(r.results.length, 1);
+  assert.equal(r.pages, undefined);
+});
+
+test('deepSearch: bir sorgu çökerse diğerleri kurtarır; boşsa ok:false', async () => {
+  const r1 = await research.deepSearch(
+    { queries: ['patlar', 'iyi'] },
+    {
+      search: async (q) => { if (q === 'patlar') throw new Error('boom'); return [{ title: 'A', url: 'https://a.com' }]; },
+      readPage: async () => ({ ok: false }),
+    }
+  );
+  assert.ok(r1.ok && r1.results.length === 1);
+  const r2 = await research.deepSearch(
+    { queries: ['yok1', 'yok2'] },
+    { search: async () => [], readPage: async () => ({ ok: false }) }
+  );
+  assert.equal(r2.ok, false);
+  assert.match(r2.error, /boş/);
+});
+
+test('deepSearch: sorgu yoksa net hata; queries string de kabul edilir', async () => {
+  const bad = await research.deepSearch({}, { search: async () => [] });
+  assert.equal(bad.ok, false);
+  const r = await research.deepSearch(
+    { queries: 'tek sorgu' },
+    { search: async () => [{ title: 'A', url: 'https://a.com' }] }
+  );
+  assert.deepEqual(r.queries, ['tek sorgu']);
+});
+
+test('SKIP_FILE_RE: pdf/görsel/arşiv yakalanır, sayfa yakalanmaz', () => {
+  assert.ok(research.SKIP_FILE_RE.test('https://x.com/a.pdf'));
+  assert.ok(research.SKIP_FILE_RE.test('https://x.com/img.png?w=9'));
+  assert.ok(!research.SKIP_FILE_RE.test('https://x.com/article'));
+});