beast-agent 1.2.2 → 1.3.0

package/package.json

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

package/src/agent/engine.js

@@ -16,10 +16,14 @@ const skills = require('./skills');
 const { estTokens, estMsgTokens } = require('./tokens');
 const log = require('./logger');
 
-const MAX_TURNS = 25;
+const MAX_TURNS = 40;
 const SUB_MAX_TURNS = 8;
 const HISTORY_TOKEN_BUDGET = 18000;
 const TOOL_OUT_KEEP = 1200;
+/* read_file sonuçları dosya HAFIZASI'dır: 7200 char'a kırpma modeli aynı
+   dosyayı offset offset tekrar okuyor → tur limiti doluyordu. Son okuma
+   oturum sonuna kadar tam tutulur (yaklaşık 48k char ≈ orta boy kaynak dosya). */
+const READ_OUT_KEEP = 48000;
 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 */
@@ -1385,9 +1389,9 @@ class Engine {
         ? '# PROJE TALİMATLARI (workspace AGENTS/CLAUDE/CONTEXT dosyalarından — daima uy)\n' + proj + '\n'
         : '') +
       'WORKFLOW (her işte bu sıra):\n' +
-      '1) BAĞLAM: değiştirmeden önce ilgili dosyaları OKU — read_file satır numaralı döner (N: içerik); büyük dosyada devamını offset parametresiyle oku, ASLA baştan okuma; bir dosyayı aynı oturumda BİR KEZ okumak yeter — içeriği bağlamda zaten var. İçerik araması için grep (regex), dosya adı araması için glob kullan; varsayım yapma, mevcut stili/konvansiyonu takip et.\n' +
+      '1) BAĞLAM: değiştirmeden önce ilgili dosyaları OKU — read_file satır numaralı döner (N: içerik); büyük dosyada devamını offset parametresiyle oku, ASLA baştan okuma; bir dosyayı aynı oturumda BİR KEZ okumak yeter — okuduğun içerik oturum SONUNA KADAR bağlamda KALIR, edit yaptıktan sonra dosyayı yeniden okuma YASAK (güncel durum = son okuma + kendi editlerin). İçerik araması için grep (regex), dosya adı için glob kullan; varsayım yapma, mevcut stili/konvansiyonu takip et.\n' +
       '2) PLAN: 2+ adımlı işlerde İLK EYLEM todo_write olsun (2-6 madde); her adım bitince status:"done" ile GÜNCELLE — liste bitene kadar iş bitmiş sayılmaz.\n' +
-      '3) EDİT: VAR OLAN dosyada önce edit_file kullan (old_string/new_string ile yalnız ilgili bölümü değiştir; birden çok eşleşme varsa bağlam ekle ya da replace_all); write_file yalnız YENİ dosya ya da tam yeniden yazım için. İlgisiz yeniden biçimleme/kayıt boşluk değişikliği YAPMA. edit_file/write_file sonucu additions/deletions döner ve değişiklik diske ANINDA uygulanır — doğrulamak için dosyayı TEKRAR OKUMA YASAK; sonraki editi önceki okuduğun içerik + kendi değişikliklerin üzerinden zincirle.\n' +
+      '3) EDİT: VAR OLAN dosyada önce edit_file kullan (old_string/new_string ile yalnız ilgili bölümü değiştir; birden çok eşleşme varsa bağlam ekle ya da replace_all); write_file yalnız YENİ dosya ya da tam yeniden yazım için. Dosya işlemleri için ÖZEL ARAÇLARI kullan (edit_file/write_file/read_file/grep/glob); run_command terminal işlerindir (build, git, kurulum, paket) — dosya düzenlemeyi komut/scripte yedirme, edit_file ile yap. İlgisiz yeniden biçimleme/kayıp boşluk değişikliği YAPMA. edit_file/write_file sonucu additions/deletions döner ve değişiklik diske ANINDA uygulanır — doğrulamak için dosyayı TEKRAR OKUMA YASAK; sonraki editi önceki okuduğun içerik + kendi değişikliklerin üzerinden zincirle.\n' +
       '4) DOĞRULA: edit sonrası mümkünse derle/test et/lint çalıştır (run_command); hata varsa DÜZELT ve TEKRAR dene (en fazla 2 doğrulama turu) — kırmızı bırakma. Doğrulama read_file ile DEĞİL run_command ile yapılır.\n' +
       '5) RAPOR: 1-3 satır — ne değişti + doğrulama sonucu (ör. "npm test ✓ 154/154"). Uzun açıklama yok.\n' +
       'CANLI ÖNİZLEME: web sitesi/app üretirsen son adımda ÇALIŞIR halde bırak (dev server ayakta ya da index.html yazılmış) — panel iş bitince ürettiğin şeyi dahili tarayıcıda otomatik canlı açar.\n' +
@@ -1478,13 +1482,13 @@ class Engine {
       '# ARAÇ KURALLARI\n' +
         [
           'Basit soruları araç kullanmadan doğrudan cevapla — hız önceliklidir.',
-          'Kod/dosya işlerinde: içerik araması grep (regex), dosya adı araması glob, VAR OLAN dosyayı değiştirme edit_file (write_file yalnız yeni dosya/tam yeniden yazım). read_file satır numaralı döner; büyük dosyada devamını offset parametresiyle oku, ASLA baştan okuma; bir dosyayı aynı oturumda BİR KEZ okumak yeter. edit_file/write_file sonucu additions/deletions döner ve değişiklik diske ANINDA uygulanır — doğrulamak için dosyayı TEKRAR OKUMA; önceki okuduğun içerik + kendi değişikliklerin üzerinden devam et.',
+          'Kod/dosya işlerinde: içerik araması grep (regex), dosya adı araması glob, VAR OLAN dosyayı değiştirme edit_file (write_file yalnız yeni dosya/tam yeniden yazım). read_file satır numaralı döner; büyük dosyada devamını offset parametresiyle oku, ASLA baştan okuma; bir dosyayı aynı oturumda BİR KEZ okumak yeter — okunan içerik oturum sonuna kadar bağlamda kalır, dosyayı tekrar okuma. Dosya işlemlerinde özel araçları kullan (edit_file/write_file/read_file/grep/glob); run_command terminal işlerindir (build, git, kurulum, paket) — dosya düzenlemeyi komutla değil edit_file ile yap. edit_file/write_file sonucu additions/deletions döner ve değişiklik diske ANINDA uygulanır — doğrulamak için dosyayı TEKRAR OKUMA; önceki okuduğun içerik + kendi değişikliklerin üzerinden devam et.',
           'Kullanıcı bir tarihte/saatte hatırlatılmasını isterse set_reminder kullan; when değerini ORTAMdaki bugüne göre hesapla (yerel saat). "Her sabah/gün/hafta" gibi tekrarlı isteklerde repeat alanını da ver (daily/weekly/monthly/weekdays veya cron).',
                     '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. 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.',
+          '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 DEĞİL AYNI turda PARALEL edit_file çağrılarıyla yap (dosya düzenlemeyi komut/scripte yedirme). 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.',
@@ -1616,16 +1620,27 @@ class Engine {
       }
       return m;
     });
+    /* opencode file-state portu: read_file sonuçları bağlamda YAŞAR —
+       kırpma modeli "unuttu" diye tekrar tekrar okumaya zorluyordu.
+       opencode'ta araç çıktıları tam tutulur; eski okumalar stub'a inmez —
+       bütçe dolunca en eski birimler doğal olarak pencere dışı kalır
+       (opencode prune mantığıyla aynı). Okumalar READ_OUT_KEEP ile sınırlı. */
+    const READ_KEEP = READ_OUT_KEEP; /* depolama tavanıyla hizalı */
     for (let k = 0; k < flat.length; k++) {
       const m = flat[k];
       if (m.role !== 'tool') continue;
-      const tooLong = String(m.content || '').length > TOOL_OUT_KEEP * 2;
-      /* diffView UI-only metadata'dır — sağlayıcıya GİTMEZ (bilinmeyen alan
-         reddi + token israfı önlenir); kırpma ile aynı kopyada birleştirilir */
-      if (tooLong || m.diffView) {
+      const len = String(m.content || '').length;
+      let content;
+      if (m.name === 'read_file') {
+        content = len > READ_KEEP ? String(m.content).slice(0, READ_KEEP) + '\n…[kırpıldı — devam için offset ile oku]' : null; /* TAM KORUNUR */
+      } else {
+        content = len > TOOL_OUT_KEEP * 2 ? String(m.content).slice(0, TOOL_OUT_KEEP) + '\n…[kırpıldı]' : null;
+      }
+      /* diffView UI-only metadata'dır — sağlayıcıya GİTMEZ */
+      if (content !== null || m.diffView) {
         const rest = { ...m };
         delete rest.diffView;
-        if (tooLong) rest.content = String(m.content).slice(0, TOOL_OUT_KEEP) + '\n…[kırpıldı]';
+        if (content !== null) rest.content = content;
         flat[k] = rest;
       }
     }
@@ -1870,10 +1885,28 @@ class Engine {
       const msgs = session.messages;
       let total = 0, pruned = 0, turns = 0;
       const targets = [];
+      /* her dosyanın EN SON read_file sonucu asla prune edilmez — dosya
+         hafızası oturum sonuna kadar yaşar; eski okumalar serbest */
+      const readPathOf = (m) => {
+        const s = String(m.content || '');
+        const mm = /"path"\s*:\s*"((?:[^"\\]|\\.)*)"/.exec(s.slice(0, 600));
+        return mm ? mm[1] : null;
+      };
+      const lastReadId = new Map();
+      for (const m of msgs) {
+        if (m.role === 'tool' && m.name === 'read_file' && m.tool_call_id) {
+          const p = readPathOf(m);
+          if (p) lastReadId.set(p, m.tool_call_id);
+        }
+      }
       for (let i = msgs.length - 1; i >= 0; i--) {
         const m = msgs[i];
         if (m.role === 'user') turns++;
         if (turns < 2) continue; // en yeni tur dokunulmaz
+        if (
+          m.role === 'tool' && m.name === 'read_file' && m.tool_call_id &&
+          readPathOf(m) && lastReadId.get(readPathOf(m)) === m.tool_call_id
+        ) continue; // son dosya okuması korumalı
         if (m.role === 'tool' && typeof m.content === 'string' && m.content.length > 400) {
           const est = Math.ceil(estTokens(m.content) * this.tokRatio);
           total += est;
@@ -2662,6 +2695,7 @@ class Engine {
       (job.task ? `GÖREV: ${job.task}\n` : '') +
       `Ortam: Windows + PowerShell; çalışma klasörü: ${this.workspace}\n` +
       `GENEL AJAN DİSİPLİNİ: görevi A'dan Z'ye yürüt — bağlam topla, uygula, DOĞRULA; yarım bırakma; doğrulama sonucunu rapora yaz.\n` +
+      `DOSYA KURALI: dosya işlemlerinde özel araçları kullan — VAR OLAN dosyayı edit_file ile düzenle, yeniyi write_file ile yaz, okuma/arama read_file/grep/glob; run_command terminal işlerindir (build, git, kurulum). Bir dosyayı BİR KEZ oku — içerik bağlamda kalır, tekrar okuma.\n` +
       (proj ? `PROJE TALİMATLARI (workspace AGENTS/CLAUDE/CONTEXT — daima uy):\n${proj}\n` : '') +
       `HIZ KURALLARI:\n` +
       `- Döngülü işleri (çok URL/dosya/sayfa, tekrarlı parse-hesap) TEK python_run betiğinde topluca bitir.\n` +
@@ -2676,7 +2710,7 @@ class Engine {
 
   /* uzun bg işlerinde geçmiş şişer → payload büyür, hız düşer. Son N mesaj kalsın
      (+ asıl görev mesajı); kopuk tool çifti sınırı hizalanır */
-  static BG_KEEP_MSGS = 24;
+  static BG_KEEP_MSGS = 48;
   _bgTrim(session) {
     const max = Engine.BG_KEEP_MSGS;
     const msgs = session.messages;
@@ -2911,17 +2945,23 @@ class Engine {
       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)
       let usageTotal = 0; // en yüksek görülen total_tokens — compaction tetiği
-      let compacted = false; // run başına en fazla 1 compaction
-      /* opencode agent.steps port: özel ajanın kendi tur limiti (2-60) */
+      let lastCompactTurn = -99; // opencode: compaction run başına 1 DEĞİL — her taşmada tekrar eder
+      /* opencode agent.steps port: özel ajanın kendi tur limiti (2-60).
+         ANA OTURUMDA SERT TUR LİMİTİ YOK (opencode birebir): bağlam dolunca
+         compaction özetler ve işin ORTASINDA devam eder; sonsuz döngüyü
+         doom-loop koruması + kullanıcı ■ kırar. bg ajanlarda kapanış
+         disiplini için tavan kalır. */
       const runDef = this._agentDefFor(session, !!session.bgJob);
-      const maxTurns = Math.max(2, Math.min(60, (runDef && runDef.steps) || MAX_TURNS));
+      const maxTurns = session.bgJob
+        ? Math.max(2, Math.min(60, (runDef && runDef.steps) || MAX_TURNS))
+        : Infinity;
       const recentSigs = []; // doom-loop dedektörü: son araç imzaları
       /* Beast Code canlı önizleme: run boyunca üretilen eserleri topla —
          iş bitince dahili tarayıcıda CANLI açılır (site/dev server/HTML) */
       const bcArtifacts = session.bcCode ? { html: [], serverUrl: null } : null;
       for (let turn = 0; turn < maxTurns; turn++) {
-        /* SÜRE SINIRI YOK — ama sonsuz tur da yok: bg ajan son 3 tura gelirken
-           "raporu yaz ve bitir" uyarısı alır; maxTurns sert tavan olarak kalır. */
+        /* SÜRE SINIRI YOK. Ana oturum sınırsız tur koşar (opencode birebir);
+           yalnız bg ajan son 3 tura gelirken "raporu yaz ve bitir" uyarısı alır. */
         if (session.bgJob && turn === maxTurns - 3 && !wrapNudged) {
           wrapNudged = true;
           const wmsg = {
@@ -2935,26 +2975,16 @@ class Engine {
           } catch {}
           emit({ type: 'message', message: wmsg });
         }
-        /* opencode port (prompt.ts:1281): ana oturumda son turda zorunlu
-           nihai cevap — tur limiti sessizce dolup boş 'done' dönmesin */
-        if (!session.bgJob && turn === maxTurns - 1 && !wrapNudged) {
-          wrapNudged = true;
-          const wmsg = {
-            role: 'user',
-            content:
-              '[SON TUR] Tur limitine ulaşıldı: YENİ araç çağırma — eldeki bilgilerle NİHAİ cevabını şimdi ver. Eksikler varsa açıkça belirt.',
-          };
-          session.messages.push(wmsg);
-          try {
-            this._append(session, wmsg);
-          } catch {}
-          emit({ type: 'message', message: wmsg });
-        }
-        /* opencode port (prompt.ts:1161 + overflow.ts): bağlam dolduysa
-           compaction checkpoint — kuyruk korunur, baş özetlenir */
+        /* opencode port (prompt.ts:1161 + overflow.ts + processor.ts "compact"):
+           bağlam dolduysa compaction — kuyruk korunur, baş özetlenir ve işin
+           ORTASINDA devam edilir. Run içinde TEKRAR EDELİR; taze compaction'dan
+           hemen sonra hâlâ taşarsa opencode ContextOverflowError gibi güvenli dur. */
         const selNow = this.sessionModel.get(String(sid)) || this.modelFor(null) || this.sel;
-        if (!compacted && this._overContext(session, selNow, usageTotal)) {
-          compacted = true;
+        if (this._overContext(session, selNow, usageTotal)) {
+          if (turn - lastCompactTurn < 4) {
+            throw new Error('ContextOverflow: compaction sonrası bağlam hâlâ model limitinin üstünde — oturum çok büyük');
+          }
+          lastCompactTurn = turn;
           await this._compactHistory(session, selNow, ctrl.signal);
         }
         this._bgTrim(session); // #21 bg geçmişini olabildiğince ince tut
@@ -3112,7 +3142,7 @@ class Engine {
               }
               if (injectedImage || diffView) out = JSON.stringify(obj);
             } catch {}
-            const toolMsg = { role: 'tool', tool_call_id: tc.id, name, content: out.slice(0, TOOL_OUT_KEEP * 6) };
+            const toolMsg = { role: 'tool', tool_call_id: tc.id, name, content: out.slice(0, name === 'read_file' ? READ_OUT_KEEP : TOOL_OUT_KEEP * 6) };
             if (diffView) toolMsg.diffView = diffView; /* oturum dosyasına da düşer — geçmiş açılınca diff yeniden çizilir */
             session.messages.push(toolMsg);
             try {
@@ -3134,8 +3164,10 @@ class Engine {
           })
         );
       }
+      /* yalnız bg ajanlar tavanla buraya düşebilir — ana oturum sınırsız koşar */
       emit({ type: 'done', usage: null });
-      this._bgFinish(sid, 'error', 'tur limiti doldu (maxTurns)');    } catch (e) {
+      this._bgFinish(sid, 'error', 'bg görevi tur limitine ulaştı (maxTurns)');
+    } catch (e) {
       const aborted = e && (e.name === 'AbortError' || ctrl.signal.aborted);
       if (aborted) {
         this._clearCrash(); // kullanıcı durdurdu — kurtarma yok

package/src/agent/tools.js

@@ -1302,13 +1302,32 @@ function diffRegion(before, after) {
   return { before: capDiffText(beforeRegion), after: capDiffText(afterRegion), startLine: start + 1 };
 }
 
+/* ---------- read_file disk-cache (opencode file-state portu) ----------
+   mtime+size değişmemişse dosya yeniden diskten OKUNMAZ — cache'ten döner.
+   edit_file/write_file kendi yazdıklarından sonra cache'i düşürür; böylece
+   sonraki okuma daima güncel içerik verir. */
+const _readCache = new Map(); /* abs → { mtimeMs, size, raw } */
+
+function readCacheGet(abs, st) {
+  const hit = _readCache.get(abs);
+  if (hit && hit.mtimeMs === st.mtimeMs && hit.size === st.size) return hit.raw;
+  const raw = fs.readFileSync(abs, 'utf8');
+  if (_readCache.size > 200) _readCache.delete(_readCache.keys().next().value);
+  _readCache.set(abs, { mtimeMs: st.mtimeMs, size: st.size, raw });
+  return raw;
+}
+
+function readCacheDrop(abs) {
+  _readCache.delete(abs);
+}
+
 const definitions = [
   {
     type: 'function',
     function: {
       name: 'run_command',
       description:
-        'Run a PowerShell command on the user\'s Windows machine in the workspace directory and return combined stdout/stderr. Use for shell tasks, builds, git, installs, etc.',
+        'Executes a given PowerShell command on the user\'s Windows machine in the workspace directory and returns combined stdout/stderr. Use this tool for terminal operations like builds, git, npm installs, docker, etc. DO NOT use it for file operations (reading, writing, editing, searching, finding files) - use the specialized tools for this instead: read_file, write_file, edit_file, grep, glob.',
       parameters: {
         type: 'object',
         properties: {
@@ -1335,7 +1354,8 @@ const definitions = [
         '- Contents are returned with each line prefixed by its line number as `<line>: <content>`. For example, if a file has contents "foo\\n", you will receive "1: foo\\n".\n' +
         '- Any line longer than 2000 characters is truncated.\n' +
         '- Call this tool in parallel when you know there are multiple files you want to read.\n' +
-        '- Avoid tiny repeated slices (30 line chunks). If you need more context, read a larger window.',
+        '- Avoid tiny repeated slices (30 line chunks). If you need more context, read a larger window.\n' +
+        '- File contents you read STAY in your context for the WHOLE session. Do NOT re-read a file you already read: chain edits from your previous read plus your own edit_file/write_file results. Re-reading the same file (same or overlapping range) wastes turns and is forbidden unless the file actually changed on disk outside your own edits.',
       parameters: {
         type: 'object',
         properties: {
@@ -1383,7 +1403,8 @@ const definitions = [
         '- The edit will FAIL if `old_string` is not found in the file with an error "oldString not found in content".\n' +
         '- The edit will FAIL if `old_string` is found multiple times in the file with an error "Found multiple matches for oldString. Provide more surrounding lines in old_string to identify the correct match." Either provide a larger string with more surrounding context to make it unique or use `replace_all` to change every instance of `old_string`.\n' +
         '- Use `replace_all` for replacing and renaming strings across the file. This parameter is useful if you want to rename a variable for instance.\n' +
-        '- The result includes additions/deletions counts — the change is APPLIED to disk immediately; do NOT read the file again to verify.',
+        '- The result includes additions/deletions counts — the change is APPLIED to disk immediately; do NOT read the file again to verify.\n' +
+        '- Chain follow-up edits from what you already read plus your own previous edits — do NOT re-read the file between edits. Multiple edit_file calls to different files can be issued in PARALLEL in one turn.',
       parameters: {
         type: 'object',
         properties: {
@@ -1558,6 +1579,7 @@ async function exec(name, args, ctx) {
             }
             fs.mkdirSync(path.dirname(filePath), { recursive: true });
             fs.writeFileSync(filePath, newS, 'utf8');
+            readCacheDrop(filePath);
             const counts = diffLineCounts('', newS);
             const out = { ok: true, path: filePath, note: 'Edit applied successfully.', replacements: 1, ...counts };
             if (ctx.wantDiff) out.diffView = { path: filePath, before: '', after: capDiffText(newS), startLine: 1, ...counts };
@@ -1573,6 +1595,7 @@ async function exec(name, args, ctx) {
           const rep = ocReplace(contentOld, oldN, newN, !!(args.replace_all || args.replaceAll));
           const contentNew = rep.result;
           fs.writeFileSync(filePath, contentNew, 'utf8');
+          readCacheDrop(filePath); /* sonraki read_file taze içerik okusun */
           const counts = diffLineCounts(contentOld, contentNew);
           const out = {
             ok: true,
@@ -1612,7 +1635,7 @@ async function exec(name, args, ctx) {
             return JSON.stringify({ ok: false, error: 'pdf okuma hata: ' + String((e2 && e2.message) || e2) });
           }
         }
-        let raw = fs.readFileSync(abs, 'utf8');
+        let raw = readCacheGet(abs, st);
         /* opencode read.ts port: satır numaralı çıktı (`N: içerik`), offset/limit
            penceresi (1-indexed), 2000 satır varsayılan, uzun satır kırpma */
         const allLines = raw.split('\n');
@@ -1661,6 +1684,7 @@ async function exec(name, args, ctx) {
         const before = existed && !fs.statSync(abs).isDirectory() ? fs.readFileSync(abs, 'utf8') : '';
         fs.mkdirSync(path.dirname(abs), { recursive: true });
         fs.writeFileSync(abs, content, 'utf8');
+        readCacheDrop(abs); /* sonraki read_file taze içerik okusun */
         const counts = diffLineCounts(before, content);
         const out = { ok: true, path: abs, bytes: Buffer.byteLength(content), ...counts };
         if (ctx.wantDiff) {

package/src/main.js

@@ -2439,6 +2439,7 @@ function reloadBackend() {
     emit: (ev) => {
       if (win && !win.isDestroyed()) win.webContents.send('agent:event', ev);
       flushDesktopOnDone(ev); /* biriken desktop mesajlarını sıraya bas */
+      bcFlushOnDone(ev); /* Beast Code kuyruğunu iş bitiminde boşalt */
       /* WA canlı iş takibi: oturum bir WhatsApp sohbetine bağlıysa araç
          hareketlerini (terminal, web, dosya…) kısa satırla bildir.
          Spam olmasın: sohbet başına en az 7 sn'de bir tek satır. */
@@ -5266,6 +5267,66 @@ function bcPanelEvent(sid, ev) {
   } catch {}
 }
 
+/* Beast Code mesaj kuyruğu: ajan çalışırken gelen mesajlar birikir, iş bitince
+   TEK pakette (metinler \n ile birleşik) gönderilir. Boştayken de kısa pencere
+   (debounce) vardır — ard arda hızlı mesajlar tek işte birleşir. */
+const BC_DEBOUNCE_MS = 900;
+const bcQueue = new Map(); /* klasör yolu → { timer, msgs[] } */
+
+function bcQueuePush(ws, text) {
+  let q = bcQueue.get(ws);
+  if (!q) {
+    q = { timer: null, msgs: [] };
+    bcQueue.set(ws, q);
+  }
+  q.msgs.push({ text });
+  return q;
+}
+
+function bcFlush(folder) {
+  const q = bcQueue.get(folder);
+  if (!q || !q.msgs.length) return;
+  const s = bcGetSession(folder); /* oturum yoksa oluşturur */
+  if (engine.isBusy(s.id)) return; /* hâlâ çalışıyor — done/error eventini bekle */
+  let merged = '';
+  for (const m of q.msgs) if (m.text) merged += (merged ? '\n' : '') + m.text;
+  if (!merged.trim()) {
+    bcQueue.delete(folder);
+    clearTimeout(q.timer);
+    return;
+  }
+  s.workspace = folder;
+  s.bcCode = true;
+  engine.cache.set(s.id, s);
+  if (engine.send(s.id, merged)) {
+    bcQueue.delete(folder);
+    clearTimeout(q.timer);
+  } else {
+    /* yarış: az önce meşgul oldu — kuyruk korunur, kısa süre sonra tekrar denenir */
+    q.retries = (q.retries || 0) + 1;
+    if (q.retries > 5) {
+      bcQueue.delete(folder);
+      clearTimeout(q.timer);
+      try {
+        if (win && !win.isDestroyed()) {
+          win.webContents.send('agent:event', { sessionId: s.id, type: 'error', error: 'Beast Code mesajı gönderilemedi — panele tekrar yaz' });
+        }
+      } catch {}
+      return;
+    }
+    setTimeout(() => { try { bcFlush(folder); } catch {} }, 800);
+  }
+}
+
+function bcFlushOnDone(ev) {
+  if (!ev || (ev.type !== 'done' && ev.type !== 'error') || !ev.sessionId) return;
+  for (const [folder, sid] of bcSessions) {
+    if (String(sid) === String(ev.sessionId) && bcQueue.has(folder)) {
+      setTimeout(() => { try { bcFlush(folder); } catch {} }, 150);
+    }
+  }
+}
+
 ipcMain.handle('beastcode:send', async (_e, payload) => {
   const text = String((payload && payload.msg) || '').trim();
   if (!text) return { ok: false, error: 'boş mesaj' };
@@ -5274,13 +5335,16 @@ ipcMain.handle('beastcode:send', async (_e, payload) => {
   const modeM = /^\/(plan|build|auto)\b/i.exec(text);
 
   if (!engine.publicState().hasModel) return { ok: false, error: 'model yok — Ayarlar → Provider sekmesinden ekle' };
-  if (engine.isBusy(bcSessions.get(ws))) return { ok: false, busy: true, error: 'önceki mesaj sürüyor — ■ ile durdurabilirsin' };
+  /* oturumu HEMEN aç: cevap daima gerçek sessionId taşır — renderer paneli bu id ile
+     eşler; boşta/kuyrukta olsa bile id yoksa panel olayları eşleyemez ve ölü kalır */
   const s = bcGetSession(ws);
   s.workspace = ws; /* soldaki klasörde çalış */
   s.bcCode = true; /* todo disiplini + iş sonu hızlı kapanış (engine) */
+  engine.cache.set(s.id, s);
+  const busy = engine.isBusy(s.id);
   if (modeM) {
+    /* mod değişimi anında uygulanır — meşgulken de (yalnız bayrak; engine çakışmaz) */
     s.bcMode = modeM[1].toLowerCase();
-    engine.cache.set(s.id, s);
     if (win && !win.isDestroyed()) {
       const body = modeM[1].toLowerCase() === 'plan'
         ? 'PLAN MODU — dosyaları okuyup inceler, KOD YAZMAZ; adım adım uygulama planı verir.'
@@ -5291,25 +5355,44 @@ ipcMain.handle('beastcode:send', async (_e, payload) => {
     }
     return { ok: true, sessionId: s.id, mode: s.bcMode };
   }
-  engine.cache.set(s.id, s);
-  const ok = engine.send(s.id, text);
-  if (!ok) return { ok: false, error: 'mesaj gönderilemedi' };
-  return { ok: true, sessionId: s.id };
+  if (busy) {
+    /* ajan çalışıyor → kuyruğa al; iş bitince (done/error) toplu gider */
+    const q = bcQueuePush(ws, text);
+    return { ok: true, queued: true, count: q.msgs.length, sessionId: s.id };
+  }
+  /* boşta: kısa pencere — hızlı ard arda mesajlar tek işte birleşir */
+  const q = bcQueuePush(ws, text);
+  clearTimeout(q.timer);
+  q.timer = setTimeout(() => { try { bcFlush(ws); } catch {} }, BC_DEBOUNCE_MS);
+  return { ok: true, sessionId: s.id, pending: true };
 });
 
 ipcMain.handle('beastcode:stop', async () => {
   const ws = ideRoot();
   const sid = bcSessions.get(ws);
-  if (!sid) return { ok: false };
+  /* durdurma: bekleyen kuyruğu da boşalt (kullanıcı vazgeçti) */
+  const q = bcQueue.get(ws);
+  if (q) {
+    clearTimeout(q.timer);
+    bcQueue.delete(ws);
+  }
+  const wasBusy = sid ? engine.isBusy(sid) : false;
   let r = false;
-  try { r = engine.interrupt(sid, 'kullanıcı Beast Code panelinden ■ ile durdurdu'); } catch {}
-  return { ok: !!r };
+  if (wasBusy) {
+    try { r = engine.interrupt(sid, 'kullanıcı Beast Code panelinden ■ ile durdurdu'); } catch {}
+  }
+  return { ok: true, wasBusy, interrupted: r };
 });
 
 ipcMain.handle('beastcode:new', async () => {
   const ws = ideRoot();
   const sid = bcSessions.get(ws);
   if (sid && engine.isBusy(sid)) return { ok: false, error: 'mesaj sürüyor — önce ■ ile durdur' };
+  const q = bcQueue.get(ws);
+  if (q) {
+    clearTimeout(q.timer);
+    bcQueue.delete(ws);
+  }
   if (sid) {
     try { engine.deleteSession(sid); } catch {}
     bcSessions.delete(ws);

package/src/renderer/i18n.js

@@ -509,6 +509,8 @@
       tipStore: 'Skills Store',
       tipGithub: 'GitHub Trending — repoları favorile, chate at, ajana araştır',
       tipIde: 'IDE Modu — dosyalar + chat + preview',
+      tipCodeHide: 'Editörü kapat',
+      tipCodeShow: 'Editörü göster',
       ide_files: 'DOSYALAR',
       ide_pick: 'Klasör seç',
       ide_refresh: 'Yenile',
@@ -1122,6 +1124,8 @@
       tipStore: 'Skills Store',
       tipGithub: 'GitHub Trending — favorite repos, send to chat, ask the agent',
       tipIde: 'IDE Mode — files + chat + preview',
+      tipCodeHide: 'Hide editor',
+      tipCodeShow: 'Show editor',
       ide_files: 'FILES',
       ide_pick: 'Choose folder',
       ide_refresh: 'Refresh',

package/src/renderer/index.html

@@ -111,6 +111,7 @@
             <div id="codeTabs"></div>
             <code id="codePath" title="">—</code>
             <button id="codeSave" title="Kaydet (Ctrl+S)">Kaydet</button>
+            <button id="codeHide" title="Editörü kapat" data-i18n-title="tipCodeHide">&#x2715;&#xFE0E;</button>
           </div>
           <div id="codeBody">
             <div id="codeGutter" aria-hidden="true"></div>
@@ -125,6 +126,7 @@
             <span id="bcTitle">BEAST CODE</span>
             <span id="bcCwd" title=""></span>
             <span class="file-spacer"></span>
+            <button id="codeShow" title="Editörü göster" data-i18n-title="tipCodeShow" hidden>&#x25A3;&#xFE0E;</button>
             <button id="bcNew" title="Yeni oturum" data-i18n-title="bc_new">＋</button>
             <button id="bcClear" title="Çıktıyı temizle" data-i18n-title="bc_clear">Temizle</button>
           </div>

package/src/renderer/renderer.js

@@ -83,6 +83,8 @@ const els = {
   codeGutter: $('#codeGutter'),
   codePath: $('#codePath'),
   codeSave: $('#codeSave'),
+  codeHide: $('#codeHide'),
+  codeShow: $('#codeShow'),
   ideRow: $('#ideRow'),
   ideSplit: $('#ideSplit'),
   bcPanel: $('#bcPanel'),
@@ -4167,6 +4169,8 @@ function onEvent(ev) {
       break;
     }
     case 'status':
+      /* kuyruktan tetiklenen yeni iş: kilitle kendiliğinden açılmışsa geri kapat */
+      if (ev.status !== 'idle' && !busy) setBusy(true);
       if (!busy) break;
       setStatus(ev.status === 'idle' ? (busy ? 'düşünüyor…' : '') : ev.status === 'thinking' ? 'düşünüyor…' : ev.status + '…');
       break;
@@ -5922,12 +5926,29 @@ async function setIdeMode(on) {
   }
   if (on) {
     ideSplitRestore();
+    setEditorHidden(localStorage.getItem('beast.editorHidden') === '1');
     await loadIdeTree();
     bcBanner();
     codeGutterRender(); /* dosya açık olmasa bile rakamlar görünür */
   }
 }
 
+/* ---------- editör panelini kapat/göster ----------
+   Kapatınca kod bölmesi gider, Beast Code tam genişlik alır; tercih
+   localStorage'da kalıcıdır. Dosya ağacından dosya açınca geri açılır. */
+function editorHiddenOn() {
+  return document.body.classList.contains('editor-hidden');
+}
+
+function setEditorHidden(h) {
+  document.body.classList.toggle('editor-hidden', !!h);
+  if (els.codeShow) els.codeShow.hidden = !h;
+  try { localStorage.setItem('beast.editorHidden', h ? '1' : '0'); } catch {}
+}
+
+if (els.codeHide) els.codeHide.addEventListener('click', () => setEditorHidden(true));
+if (els.codeShow) els.codeShow.addEventListener('click', () => setEditorHidden(false));
+
 /* ---------- editor/chat ayırıcı (VS Code gibi sürükle-bırak) ----------
    Orantılı model: kaydedilen, Beast Code'un ideRow içindeki PAYI'dır (0-1).
    Tarayıcı açılınca/kapanınca/genişlik değişince row yeniden bölünür — editör
@@ -6215,6 +6236,7 @@ function codeActivate(i) {
 }
 
 async function codeOpen(rel) {
+  if (editorHiddenOn()) setEditorHidden(false); /* dosya açılınca editör geri gelir */
   const idx = codeTabs.findIndex((t) => t.rel === rel);
   if (idx >= 0) {
     codeActivate(idx);
@@ -6737,6 +6759,7 @@ function bcIngest(ev) {
       bcRenderTodos(ev.todos);
       break;
     case 'tool-start':
+      bcSetBusy(true); /* kuyruktan tetiklenen işte panel kendini kilitler */
       bcToolBoxStart(ev.callId, ev.name, ev.args);
       /* ajan dosya yazarsa/editlerse açık IDE sekmesini izlemeye al */
       if ((ev.name === 'write_file' || ev.name === 'edit_file') && ev.args && ev.args.path) codeWriteWatch.set(ev.callId, ev.args.path);
@@ -6793,7 +6816,9 @@ function bcIngest(ev) {
         bcStatusHide();
         bcRefreshPreview();
       } else {
-        /* düşünüyor… / araç adı / bağlam durumu — input üstünde canlı balon */
+        /* düşünüyor… / araç adı / bağlam durumu — input üstünde canlı balon;
+           kuyruktan tetiklenen yeni işte kilit geri kapanır */
+        bcSetBusy(true);
         bcStatusShow(ev.status === 'thinking' ? 'düşünüyor…' : String(ev.status || ''));
       }
       break;
@@ -6827,10 +6852,17 @@ function bcRunCurrent() {
     if (r && r.ok && r.mode) {
       /* /plan · /build · /auto: mod değişimi — tur AÇILMAZ, kilit anında açılır
          (bilgi satırı bc-mode olayıyla düşer, başlık rozeti güncellenir) */
-      bcSessionId = r.sessionId;
+      if (r.sessionId) bcSessionId = r.sessionId;
       bcSetBusy(false);
+    } else if (r && r.ok && r.queued) {
+      /* ajan çalışıyor → mesaj kuyrukta; iş bitince toplu gönderilir */
+      if (r.sessionId) bcSessionId = r.sessionId;
+      bcLine('t-dim', '⏳ kuyrukta (' + r.count + ') — iş bitince gönderilir');
+    } else if (r && r.ok && r.pending) {
+      /* boşta: kısa birleşme penceresi — aynı penceredeki mesajlar tek işte gider */
+      if (r.sessionId) bcSessionId = r.sessionId;
     } else if (r && r.ok) {
-      bcSessionId = r.sessionId;
+      if (r.sessionId) bcSessionId = r.sessionId;
     } else if (r && r.busy) {
       /* iş gerçekten sürüyor — kilit açılmaz, bilgi satırı düşer */
       bcLine('t-dim', (r && r.error) || 'mesaj sürüyor');
@@ -6851,7 +6883,15 @@ if (els.bcInput) {
     if (e.key === 'Enter' && !e.shiftKey) { e.preventDefault(); bcRunCurrent(); }
   });
 }
-if (els.bcStop) els.bcStop.addEventListener('click', () => beast.beastcodeStop().catch(() => {}));
+if (els.bcStop) els.bcStop.addEventListener('click', () => {
+  beast.beastcodeStop().then((r) => {
+    /* kuyrukta bekleyen mesajlar da silindi; engine boştaysa kilidi aç */
+    if (r && r.ok && r.wasBusy === false) {
+      bcSetBusy(false);
+      bcStatusHide();
+    }
+  }).catch(() => {});
+});
 if (els.bcClear) els.bcClear.addEventListener('click', () => {
   els.bcOut.innerHTML = '';
   bcTools.clear();

package/src/renderer/style.css

@@ -2492,6 +2492,26 @@ body.ide-mode #codePane { display: flex; }
   background: var(--border);
   opacity: 0.55;
 }
+/* editör kapatılabilir: kod bölmesi + ayırıcı gizlenir, Beast Code tam genişlik */
+body.ide-mode.editor-hidden #codePane,
+body.ide-mode.editor-hidden #ideSplit { display: none; }
+body.ide-mode.editor-hidden #ideRow #bcPanel { flex: 1 1 auto; min-width: 0; }
+#codeHide {
+  flex: none;
+  width: 24px;
+  height: 24px;
+  padding: 0;
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  background: transparent;
+  color: var(--muted);
+  cursor: pointer;
+  font-size: 11px;
+  line-height: 1;
+}
+#codeHide:hover { color: var(--text); border-color: var(--accent); background: var(--panel2); }
+#bcHead #codeShow { width: 26px; padding: 0; }
+#codeShow[hidden] { display: none; }
 #codeTabsBar {
   flex: none;
   display: flex;