beast-agent 0.26.0 → 0.26.2

package/src/agent/engine.js

@@ -6,9 +6,10 @@
 
 const fs = require('fs');
 const path = require('path');
-const { chatStream, chatOnce } = require('./llm');
+const { chatStream, chatStreamAuto, chatOnce } = require('./llm');
 const { chatCompletionsUrl } = require('./config');
 const tools = require('./tools');
+const research = require('./research');
 const memory = require('./memory');
 const skills = require('./skills');
 const { estTokens, estMsgTokens } = require('./tokens');
@@ -34,9 +35,10 @@ const SUP_IDLE_MIN = 2; // ...bu kadar süredir hiç aktivite yoksa TAKILDI
 const SUP_LONG_MIN = 6; // bu kadar süredir koşuyorsa ara kontrol nödü
 const SUP_NUDGE_COOLDOWN_MIN = 4; // aynı iş için iki uyarı arası min süre
 const BG_FIX_MAX = 2; // paralel ajanın otomatik öz-kurtarma hakkı (bitince CEO devreye girer)
-/* Zarif bitirme: iş BU sürede bitmezse ajan artık yeni araştırma yapmaz,
-   elindekiyle SON RAPORU yazar ve düzgün biter — "görev bitmeden patlama" yok */
-const BG_WRAP_MIN = 4;
+/* SÜRE SINIRI YOK: bg ajanlar dakika bazında kesilmez. Sonsuz döngü koruması
+   üç katmanla sağlanır: 1) aktivite yoksa öz-kurtarma + CEO (stuck denetimi),
+   2) MAX_TURNS sert tur tavanı, 3) tur limitine yaklaşınca zarif "raporu yaz"
+   uyarısı (_run içinde). Dakika bazlı wrap-up KALDIRILDI (BG_WRAP_MIN). */
 /* #5 hız: eşzamanlı arka plan LLM turu sınırı — rate-limit yemeden maksimum paralellik */
 const BG_MAX_CONCURRENT_DEFAULT = 4;
 /* #17 kalıcı başarısızlıkta owner'a anlık uyarı */
@@ -69,13 +71,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 +101,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',
@@ -202,6 +204,7 @@ class Engine {
     this.lockdown = !!opts.lockdown; // varsayılan kısıt (oturum bazlı override edilmezse)
     this.sessionPerm = new Map(); // sessionId -> ['web'] | ['web','read'] | ['chat'] (kişi/bot bazlı izin)
     this.sessionTools = new Map(); // sessionId -> Set(araç adları) — bot skill kısıtı
+    this.sessionModel = new Map(); // sessionId -> chain entry — bot bazlı model override (setSessionModel)
     this.resolveBot = opts.resolveBot || null; // botId -> bot bilgisi (main enjekte eder)
     /* bot oturumu hafıza köprüsü: botun kendi SOUL/USER/MEMORY dosyaları */
     this.botMemory = opts.botMemory || null;
@@ -333,6 +336,16 @@ class Engine {
     else this.sessionTools.delete(id);
   }
 
+  /* BOT MODEL OVERRIDE: her bot farklı model kullanabilir (sel boşsa global seçim).
+     sel biçimi: 'providerId::model' — zincirde yoksa sessizce global'e düşer. */
+  setSessionModel(sessionId, sel) {
+    const id = String(sessionId || '');
+    if (!id) return;
+    const resolved = sel ? this._resolve(String(sel)) : null;
+    if (resolved) this.sessionModel.set(id, resolved);
+    else this.sessionModel.delete(id);
+  }
+
   /* Oturumun bağlı olduğu MÜŞTERİ botu (admin/seasız → null → global hafıza) */
   _sessionBotCtx(session) {
     if (!session || !session.botId || typeof this.resolveBot !== 'function') return null;
@@ -608,7 +621,7 @@ class Engine {
             }
           }
         }
-        const res = await chatStream(
+        const res = await chatStreamAuto(
           c,
           { messages: msgs, tools: activeTools, reasoningEffort: this._thinkEffortFor(session) },
           {
@@ -1285,11 +1298,13 @@ class Engine {
                     'Kullanıcı kalıcı bir arka plan takibi isterse (fiyat eşiği, pil seviyesi, sayfa değişikliği) watcher_add ile izleyici kur; kurduktan sonra watcher_list ile doğrula ve kullanıcıya koşulu + kontrol sıklığını kısaca bildir.',
           'Anlık olay takipleri için (yeni mail, fiyat eşiği, dosya değişimi, webhook) event_subscribe kullan — cron/polling gerekmez; listeyi event_list ile göster, vazgeçirirse event_unsubscribe.',
         'Kullanıcı "artık hep böyle yap / bunu unutma" tarzı kalıcı talimat verirse kural olarak kaydet: sohbette /rule <metin> kullanmasını söyle VEYA kullanıcı isterse event_subscribe ile olaya bağlan (mail/fiyat/dosya/webhook).',
-          'Kullanıcının mesajında 2+ ayrı iş/hedef varsa (örn "X yap ve sonra Y\u2019i kontrol et") KODLAMAYA/İŞE BAŞLAMADAN önce todo_write ile plan çıkar ve sırayla yürüt; her adımı tamamlarken güncelle.',
+          'Kullanıcının mesajında 2+ ayrı iş/hedef varsa (örn "X yap ve sonra Y\u2019i kontrol et") KODLAMAYA/İŞE BAŞLAMADAN önce todo_write ile plan çıkar ve sırayla yürüt; her adımı tamamlarken güncelle. LİSTE DİSİPLİNİ: her adım bittiği AN status:"done" yap; son cevabını vermeden önce tüm maddeler done olmalı — yapılmayacaksa listeden düş. Listeyi yarım bırakma.',
+          'HIZ KURALI: Bağımsız işleri AYNI turda birden çok tool_calls ile PARALEL ver. Küçük işleri tek tek çağırma — her ayrı araç turu 5-15 sn LLM gecikmesidir: 3+ küçük komutu TEK run_command\u2019te `;` ile zincirle (örn `git status; node -v; dir`), döngülü/çoklu işleri TEK python_run betiğinde topla, çok dosyalık değişikliği TEK script ile yap. Her küçük işlem için ayrı araç çağrısı açmak yavaşlığın 1 numaralı sebebidir.',
           this.ceoMode
             ? '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.' +
@@ -1299,6 +1314,7 @@ class Engine {
           '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.',
+          '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).',
           'BEAST KAYNAK KORUMASI: Beast\u2019in kendi kurulum/kaynak kod klasörü KİLİTLİDİR — oraya dosya yazamaz, silamaz, komut/betikle değiştiremezsin; okumak serbest. Kullanıcı kodu ancak kendi eliyle dışarıdan değiştirir; böyle bir istek gelirse yapamayacağını söyle ve kullanıcının elle yapması için yol göster.',
@@ -1907,7 +1923,7 @@ class Engine {
     job.lastActivityAt = nowIso();
   }
 
-  /* Saf sınıflandırma (test edilebilir): null | 'stuck' | 'wrapup' | 'long' */
+  /* Saf sınıflandırma (test edilebilir): null | 'stuck' | 'long' */
   static superviseReason(job, nowMs) {
     if (!job || job.status !== 'running') return null;
     const started = Date.parse(job.startedAt || '') || nowMs;
@@ -1919,7 +1935,6 @@ class Engine {
       : Infinity;
     if (nudgedMin < SUP_NUDGE_COOLDOWN_MIN) return null; // yeni uyardık — boğmayalım
     if (runMin >= SUP_STUCK_START_MIN && idleMin >= SUP_IDLE_MIN) return 'stuck';
-    if (!job.wrapAt && runMin >= BG_WRAP_MIN) return 'wrapup';
     if (runMin >= SUP_LONG_MIN) return 'long';
     return null;
   }
@@ -1936,11 +1951,6 @@ class Engine {
         this._bgSelfHeal(job, now);
         continue;
       }
-      /* zarif bitirme: süre dolunca yeni araştırma yasak → SON RAPORU yazsın */
-      if (reason === 'wrapup') {
-        this._bgWrapUp(job, now);
-        continue;
-      }
       job.lastNudgeAt = nowIso();
       job.checks = (job.checks || 0) + 1;
       const det = this.bgDetail(job.id);
@@ -1979,24 +1989,6 @@ class Engine {
     this._bgKick(job, text);
   }
 
-  /* Zarif bitirme: süre dolunca ajanı kesip SON RAPORU yazmasını iste.
-     Uzatma yok, öldürme yok — mevcut bulgularla düzgün kapanış. */
-  _bgWrapUp(job, now) {
-    job.wrapAt = nowIso();
-    job.lastNudgeAt = nowIso();
-    job.checks = (job.checks || 0) + 1;
-    const runMin = Math.max(1, Math.round((now - Date.parse(job.startedAt)) / 60000));
-    const det = this.bgDetail(job.id);
-    const tail = det.ok && det.messages.length ? det.messages.slice(-3).join('\n') : '';
-    const text =
-      `[SÜRE UYARISI] "${job.title}" görevi ${runMin} dk'dır sürüyor — süre doldu.\n` +
-      `YENİ arama/fetch/sayfa açma YAPMA. Şu ana kadar bulduklarınla SON RAPORU şimdi yaz:\n` +
-      `- 3-5 madde: net sonuç + yapılamayanlar açıkça "bulunamadı" diye.\n` +
-      `Raporu yazınca görev tamamlanır — fazladan tur harcama.` +
-      (tail ? `\n\nSon çıktın:\n${tail}` : '');
-    this._bgKick(job, text);
-  }
-
   /* Arka plan oturumuna müdahale: asılı turu kes (ctrl.abort), sonra
       kurtarma mesajını bas. abort → eski _run sonlanır → send yeni tur açar.
       revive bayrağı: /stop veya silme sonrası bekleyen müdahaleler patlamasın. */
@@ -2113,8 +2105,9 @@ 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` +
+      `- PDF gerekirse pip\u2019ten paket kurma (Türkçe bozar); Node\u2019un kurulu \`pdf-lib\`+fontkit\u2019iyle .js script yazıp \`node\` ile çalıştır. md→pdf çevirme: belge çıktısını doğrudan PDF olarak üret.\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' +
       `SON ÇIKTI: 3-5 satırlık net sonuç raporu, madde madde. Soru sorma, sohbet etme.`
@@ -2221,6 +2214,11 @@ class Engine {
       role = 'terminal';
     }
     let sel = this.modelFor(role);
+    /* bot model override: rol modeli (vision/terminal) yoksa botun kendi seçimi kazanır */
+    if (!role) {
+      const ssel = this.sessionModel.get(String(session.id));
+      if (ssel) sel = ssel;
+    }
     if (role && this.roleModels[role]) {
       emitSafe(this, session.id, { type: 'status', status: `rol: ${role} → ${sel.providerName} · ${sel.model}` });
     }
@@ -2284,9 +2282,26 @@ class Engine {
     const sid = session.id;
     const emit = (ev) => this.emit({ ...ev, sessionId: sid });
     try {
-      if (!this.sel) throw new Error('Model yapılandırılmadı — %APPDATA%\\beast\\config.yaml ve .env kontrol et');
+      if (!this.sel && !this.sessionModel.get(String(session.id))) throw new Error('Model yapılandırılmadı — %APPDATA%\\beast\\config.yaml ve .env kontrol et');
 
+      let nudged = false; // görev listesi disiplini: run başına en fazla 1 hatırlatma
+      let wrapNudged = false; // tur limitine yaklaşınca zarif kapanış (bg ajanlar)
       for (let turn = 0; turn < MAX_TURNS; turn++) {
+        /* SÜRE SINIRI YOK — ama sonsuz tur da yok: bg ajan son 3 tura gelirken
+           "raporu yaz ve bitir" uyarısı alır; MAX_TURNS sert tavan olarak kalır. */
+        if (session.bgJob && turn === MAX_TURNS - 3 && !wrapNudged) {
+          wrapNudged = true;
+          const wmsg = {
+            role: 'user',
+            content:
+              '[TUR LİMİTİ YAKLAŞIYOR] Kalın son turlar: yeni araştırma/iş AÇMA — şu ana kadarki bulgularınla SON RAPORU yaz ve bitir. Yapılamayanları açıkça "bulunamadı" diye belirt.',
+          };
+          session.messages.push(wmsg);
+          try {
+            this._append(session, wmsg);
+          } catch {}
+          emit({ type: 'message', message: wmsg });
+        }
         this._bgTrim(session); // #21 bg geçmişini olabildiğince ince tut
         emit({ type: 'status', status: 'thinking' });
         const res = await this._chatTurn(session, ctrl.signal, (delta) =>
@@ -2302,6 +2317,27 @@ class Engine {
         emit({ type: 'message', message: assistant });
 
         if (!res.toolCalls || !res.toolCalls.length) {
+          /* GÖREV LİSTESİ DİSİPLİNİ: ajan işi bitti sanıyor ama listede hâlâ
+             bekleyen/aktif madde varsa BİR KEZ hatırlat ve tura devam et —
+             liste ya tamamlanmalı ya kalan maddeler listeden düşürülmeli. */
+          const todos = session.todos || this.todos.get(sid) || [];
+          const pending = todos.filter((t) => t && t.status !== 'done');
+          if (pending.length && !nudged) {
+            nudged = true;
+            const nudge = {
+              role: 'user',
+              content:
+                '[OTOMATİK HATIRLATMA] Görev listende hâlâ tamamlanmamış maddeler var: ' +
+                pending.map((t) => '"' + t.title + '"').join(', ') +
+                '. Görevi yarım bırakma: eksik adımları ŞİMDİ tamamla; gerçekten yapılmayacaksa listeden düş. todo_write ile listeyi güncelle (status:"done") ve işi kapat.',
+            };
+            session.messages.push(nudge);
+            try {
+              this._append(session, nudge);
+            } catch {}
+            emit({ type: 'message', message: nudge });
+            continue;
+          }
           /* cevap tamam → done HEMEN: kullanıcı beklemeden yeni iş yazabilsin.
              Not/memory/skill bakımı artık arka planda (_postRunHousekeeping). */
           this._clearCrash();
@@ -2694,7 +2730,7 @@ class Engine {
     ];
     try {
       for (let turn = 0; turn < SUB_MAX_TURNS; turn++) {
-        const res = await chatStream(
+        const res = await chatStreamAuto(
           sel,
           { messages: [{ role: 'system', content: system }, ...msgs.slice(1)], tools: subTools, reasoningEffort: this._thinkEffort() },
           { signal: ctrl.signal }
@@ -2719,9 +2755,43 @@ 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;
+    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;
+  }
+
   /* 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 +2802,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,76 +3137,64 @@ 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.
+           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. */
+        try {
+          emitSafe(this, sessionId, { type: 'status', status: 'derin araştırma: çoklu sorgu + gizli sayfa okuma' });
+        } catch {}
+        const deps = {
+          search: (q) => this._webSearchChain(q, 10, sessionId, signal),
+        };
+        if (this.research && typeof this.research.readPage === 'function') {
+          deps.readPage = (u) => this.research.readPage(u, signal);
+        }
+        return JSON.stringify(await research.deepSearch(args || {}, deps, signal));
+      }
       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)
-                 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. */
         const q = String((args && args.query) || '');
         const n = Number((args && args.max_results) || 8);
-        let r = null;
-        let banned = false;
-        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 {}
-          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', args, { 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 JSON.stringify(out);
-      }
+        return JSON.stringify(await this._webSearchChain(q, n, sessionId, signal));
+      }
       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' ||
@@ -3256,7 +3314,7 @@ const TOOLS = [
     function: {
       name: 'todo_write',
       description:
-        'Replace the visible task checklist for this chat. Use ONLY for multi-step work (3+ steps); do not use for simple questions. Keep titles short; update statuses as you progress; clear the list when done.',
+        'Replace the visible task checklist for this chat. Use ONLY for multi-step work (3+ steps); do not use for simple questions. Keep titles short; update statuses as you progress; clear the list when done. DISCIPLINE: mark each step done THE MOMENT it is completed; NEVER end your reply while items are still pending/active — the system bounces unfinished lists back.',
       parameters: {
         type: 'object',
         properties: {

package/src/agent/llm.js

@@ -135,7 +135,6 @@ async function streamOnce(sel, body, { signal, onDelta, onRetry } = {}, omitReas
   const toolCalls = [];
   let usage = null;
   let finishReason = null;
-  let sawDone = false;
 
   const reader = res.body.getReader();
   const decoder = new TextDecoder();
@@ -152,8 +151,7 @@ async function streamOnce(sel, body, { signal, onDelta, onRetry } = {}, omitReas
       buf = buf.slice(idx + 1);
       if (!line.startsWith('data:')) continue;
       const data = line.slice(5).trim();
-      if (!data) continue;
-      if (data === '[DONE]') { sawDone = true; continue; }
+      if (!data || data === '[DONE]') continue;
 
       let json;
       try {
@@ -187,21 +185,52 @@ async function streamOnce(sel, body, { signal, onDelta, onRetry } = {}, omitReas
     }
   }
 
-  /* YARIDA KESİLEN AKIŞ: stream erişilmeyen bir yerde koptuysa reader sessizce
-     done=true döner — yarım metni "tamamlanmış" sanmak yerine işaretle.
-     ([DONE] geldi ama finish_reason yok = sağlayıcı tuhaflığı → kabul) */
-  if (!finishReason && !sawDone) {
-    if (toolCalls.length) {
-      const e = new Error('cevap akışı yarıda kesildi (bağlantı koptu) — araç çağrısı tamamlanamadı, tekrar deneyin');
-      e.partialStream = true;
-      throw e;
-    }
-    if (content) {
-      content += '\n\n⚠ _akış yarıda kesildi (bağlantı koptu) — devam etmesini istersen tekrar yaz._';
-    }
+  return { content, reasoning, toolCalls, usage, finishReason };
+}
+
+/* usage toplama: devam turları gerçek faturalamayı yansıtsın (prompt yeniden sayılır) */
+function sumUsage(a, b) {
+  if (!a) return b || null;
+  if (!b) return a;
+  const out = {};
+  for (const k of new Set([...Object.keys(a), ...Object.keys(b)])) {
+    if (typeof a[k] === 'number' && typeof b[k] === 'number') out[k] = a[k] + b[k];
+    else out[k] = b[k] !== undefined ? b[k] : a[k];
   }
+  return out;
+}
 
-  return { content, reasoning, toolCalls, usage, finishReason };
+/* OTOMATİK DEVAM: model cevabı çıkış limiti (finish_reason='length') yüzünden
+   kelime ortasında kesilirse — özellikle free modellerin düşük varsayılan
+   limitlerinde olur — yarım cümle kullanıcıya gitmesin. Kaldığı yerden devam
+   istenip metin birleştirilir (en fazla 2 devam turu). Araç çağrılı yanıtlarda
+   ve içerik hiç gelmediyse devreye girmez; orijinal mesaj dizisi DEĞİŞTİRİLMEZ. */
+const CONTINUE_PROMPT =
+  'Yanıtın çıkış limiti nedeniyle ortadan kesildi. Kaldığın yerden DEVAM ET — baştan başlama, özetleme, açıklama yapma; yalnızca kesilen kısmın DEVAMINI yaz.';
+
+async function chatStreamAuto(sel, body, opts = {}) {
+  const first = await chatStream(sel, body, opts);
+  if (first.finishReason !== 'length' || !first.content || (first.toolCalls && first.toolCalls.length)) {
+    return first;
+  }
+  let full = first.content;
+  let last = first;
+  for (let i = 0; i < 2; i++) {
+    const msgs2 = body.messages.slice();
+    msgs2.push({ role: 'assistant', content: full });
+    msgs2.push({ role: 'user', content: CONTINUE_PROMPT });
+    let cont;
+    try {
+      cont = await chatStream(sel, { ...body, messages: msgs2 }, opts);
+    } catch {
+      break; // devam turu patlarsa elimizdeki kısmi yanıtla döneriz
+    }
+    if (!cont.content || (cont.toolCalls && cont.toolCalls.length)) break;
+    full += cont.content;
+    last = { ...cont, content: full, usage: sumUsage(first.usage, cont.usage) };
+    if (cont.finishReason !== 'length') break;
+  }
+  return last;
 }
 
 async function chatOnce(sel, body, { signal, onRetry } = {}) {
@@ -232,4 +261,4 @@ async function chatOnce(sel, body, { signal, onRetry } = {}) {
   };
 }
 
-module.exports = { chatStream, chatOnce, withRetries, friendlyError };
+module.exports = { chatStream, chatStreamAuto, chatOnce, withRetries, friendlyError, sumUsage };

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 };