beast-agent 2.44.13 → 2.45.0

package/package.json

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

package/src/agent/computeruse.js

@@ -5,7 +5,11 @@
    mouse/klavye PowerShell üzerinden user32 API ile sürülür.
 
    Güvenlik: yalnızca engine araç çağrılarıyla çalışır; koordinat sınırlı,
-   hız limiting'li (aksiyon arası min gecikme) ve yazma metni kırpılır. */
+   hız limiting'li (aksiyon arası min gecikme) ve yazma metni kırpılır.
+
+   KOORDİNAT SÖZLEŞMESİ: computer_look görüntüsü 1280px genişliğe ölçeklenir;
+   1280 tabanlı koordinatların GERÇEK ekrana çevrilmesi main.js'teki
+   computerActScaled sarmalayıcısında yapılır. Bu modül gerçek koordinat alır. */
 
 const { execFile } = require('child_process');
 
@@ -29,14 +33,141 @@ function ps(script) {
   });
 }
 
-/** Sanal masaüstü çözünürlüğü */
-async function screenSize() {
+/** Sanal masaüstü çözünürlüğü (30 sn önbellek: her aksiyonda PS açma maliyeti olmasın) */
+let sizeCache = { at: 0, w: 0, h: 0 };
+async function screenSize(force) {
+  if (!force && sizeCache.w && Date.now() - sizeCache.at < 30000) {
+    return { w: sizeCache.w, h: sizeCache.h };
+  }
   const out = await ps(
     'Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.Screen]::PrimaryScreen.Bounds.Width.ToString() + "x" + [System.Windows.Forms.Screen]::PrimaryScreen.Bounds.Height'
   );
   const m = out.match(/(\d+)x(\d+)/);
   if (!m) throw new Error('çözünürlük alınamadı');
-  return { w: Number(m[1]), h: Number(m[2]) };
+  sizeCache = { at: Date.now(), w: Number(m[1]), h: Number(m[2]) };
+  return { w: sizeCache.w, h: sizeCache.h };
+}
+
+/* koordinat kelepçesi: sanal masaüstünde negatif değerler geçerli (sol/üst monitör) */
+function clampCoord(v) {
+  const n = Math.round(Number(v));
+  if (!Number.isFinite(n)) return null;
+  return Math.max(-32000, Math.min(32000, n));
+}
+
+/* computer_look görüntüsü 1280px genişliğe ölçeklenir; modelden gelen 1280
+   tabanlı koordinatları GERÇEK ekran koordinatına çevirir (çok monitörde
+   ekran ofseti dahil). Saf fonksiyon — test edilebilir. cap:
+   { x, y, w, h, imgW, imgH } (main.js captureScreenDataUrl doldurur). */
+function scaleArgs(a, cap) {
+  const out = { ...(a || {}) };
+  if (!cap || !cap.imgW || !cap.imgH) return out;
+  const kx = cap.w / cap.imgW;
+  const ky = cap.h / cap.imgH;
+  for (const key of ['x', 'x2']) {
+    if (out[key] != null && out[key] !== '') out[key] = Math.round(cap.x + Number(out[key]) * kx);
+  }
+  for (const key of ['y', 'y2']) {
+    if (out[key] != null && out[key] !== '') out[key] = Math.round(cap.y + Number(out[key]) * ky);
+  }
+  return out;
+}
+
+const MOUSE_CLASS = `
+Add-Type @"
+using System;
+using System.Runtime.InteropServices;
+public class BMouse {
+  [DllImport("user32.dll")] public static extern bool SetCursorPos(int X, int Y);
+  [DllImport("user32.dll")] public static extern void mouse_event(uint dwFlags, int dx, int dy, int dwData, UIntPtr dwExtraInfo);
+}
+"@`;
+
+const LMB_DOWN = 0x0002;
+const LMB_UP = 0x0004;
+const RMB_DOWN = 0x0008;
+const RMB_UP = 0x0010;
+const WHEEL = 0x0800;
+
+/* Tek PS sürecinde: imleci taşı + (gerekiyorsa) tık(lar) — eski sürüm her
+   adım için ayrı süreç açıyordu (tık başına 2-3 spawn → ~1 sn gecikme). */
+function mouseScript({ x, y, down, up, dbl, settleMs = 35 }) {
+  const ev = (flags) => `[BMouse]::mouse_event(${flags}, 0, 0, 0, [UIntPtr]::Zero)`;
+  let body = '';
+  if (x != null && y != null) {
+    body += `[BMouse]::SetCursorPos(${x}, ${y}) | Out-Null\nStart-Sleep -Milliseconds ${settleMs}\n`;
+  }
+  if (down && up) {
+    body += `${ev(down)}\nStart-Sleep -Milliseconds 45\n${ev(up)}\n`;
+    if (dbl) body += `Start-Sleep -Milliseconds 70\n${ev(down)}\nStart-Sleep -Milliseconds 45\n${ev(up)}\n`;
+  }
+  return `${MOUSE_CLASS}\n${body}`;
+}
+
+/* tek çağrıda tekerlek: eski sürüm |dy|*3 ayrı süreç açıyordu (dy=10 → 30 spawn) */
+function wheelScript(x, y, dy) {
+  const delta = Math.round(dy * 720); // eski davranış: tik başına ±240 × 3 × dy
+  return (
+    `${MOUSE_CLASS}\n` +
+    `[BMouse]::SetCursorPos(${x}, ${y}) | Out-Null\n` +
+    `[BMouse]::mouse_event(${WHEEL}, 0, 0, ${delta}, [UIntPtr]::Zero)\n`
+  );
+}
+
+/* sürükle-bırak: basılı tut → ara noktalardan geç → bırak */
+function dragScript(x1, y1, x2, y2) {
+  const steps = 12;
+  return (
+    `${MOUSE_CLASS}\n` +
+    `[BMouse]::SetCursorPos(${x1}, ${y1}) | Out-Null\n` +
+    `Start-Sleep -Milliseconds 60\n` +
+    `[BMouse]::mouse_event(${LMB_DOWN}, 0, 0, 0, [UIntPtr]::Zero)\n` +
+    `for ($i = 1; $i -le ${steps}; $i++) {\n` +
+    `  $nx = [int](${x1} + (${x2} - ${x1}) * $i / ${steps})\n` +
+    `  $ny = [int](${y1} + (${y2} - ${y1}) * $i / ${steps})\n` +
+    `  [BMouse]::SetCursorPos($nx, $ny) | Out-Null\n` +
+    `  Start-Sleep -Milliseconds 18\n` +
+    `}\n` +
+    `Start-Sleep -Milliseconds 40\n` +
+    `[BMouse]::mouse_event(${LMB_UP}, 0, 0, 0, [UIntPtr]::Zero)\n`
+  );
+}
+
+/* pencere başlığına göre öne getir (menü/pencere odaklama için) */
+function focusScript(titleB64) {
+  return `
+Add-Type @"
+using System;
+using System.Text;
+using System.Runtime.InteropServices;
+public class BWin {
+  public delegate bool EnumWindowsProc(IntPtr hWnd, IntPtr lParam);
+  [DllImport("user32.dll")] public static extern bool EnumWindows(EnumWindowsProc cb, IntPtr lParam);
+  [DllImport("user32.dll")] public static extern bool IsWindowVisible(IntPtr hWnd);
+  [DllImport("user32.dll", CharSet=CharSet.Unicode)] public static extern int GetWindowText(IntPtr hWnd, StringBuilder text, int count);
+  [DllImport("user32.dll")] public static extern bool SetForegroundWindow(IntPtr hWnd);
+  [DllImport("user32.dll")] public static extern bool ShowWindow(IntPtr hWnd, int nCmdShow);
+  public static IntPtr Found = IntPtr.Zero;
+  public static string Needle = "";
+  public static bool Cb(IntPtr h, IntPtr l) {
+    if (!IsWindowVisible(h)) return true;
+    var sb = new StringBuilder(512);
+    GetWindowText(h, sb, 512);
+    var t = sb.ToString();
+    if (t.Length > 0 && t.IndexOf(Needle, StringComparison.OrdinalIgnoreCase) >= 0) { Found = h; return false; }
+    return true;
+  }
+}
+"@
+$n = [Text.Encoding]::UTF8.GetString([Convert]::FromBase64String("${titleB64}"))
+[BWin]::Needle = $n
+[BWin]::EnumWindows([BWin+EnumWindowsProc][BWin]::Cb, [IntPtr]::Zero) | Out-Null
+if ([BWin]::Found -ne [IntPtr]::Zero) {
+  [BWin]::ShowWindow([BWin]::Found, 9) | Out-Null
+  $r = [BWin]::SetForegroundWindow([BWin]::Found)
+  if ($r) { 'ok' } else { 'noforeground' }
+} else { 'notfound' }
+`;
 }
 
 /**
@@ -45,36 +176,54 @@ async function screenSize() {
  *  dblclick x y         → çift tık
  *  rightclick x y       → sağ tık
  *  move x y             → imleci taşı
- *  type text            → klavyeyle yaz (Unicode destekli, SendInput WM_CHAR benzeri)
+ *  hover x y            → taşı + menü açılsın diye bekle
+ *  drag x y x2 y2       → sürükle-bırak
+ *  focus title          → başlığı eşleşen pencereyi öne getir
+ *  type text            → klavyeyle yaz (pano köprüsü; pano geri yüklenir)
  *  key combo            → "enter", "ctrl+s", "alt+tab", "win" ...
- *  scroll dx dy         → tekerlek
+ *  scroll x y dy        → tekerlek (tek çağrı)
  */
 async function act(op, args = {}) {
   await pace();
-  const x = Math.max(0, Math.round(Number(args.x) || 0));
-  const y = Math.max(0, Math.round(Number(args.y) || 0));
+  const x = clampCoord(args.x == null ? 0 : args.x);
+  const y = clampCoord(args.y == null ? 0 : args.y);
   switch (op) {
     case 'move':
-      await mouseMove(x, y);
+      await ps(mouseScript({ x, y }));
       return { ok: true };
+    case 'hover':
+      await ps(mouseScript({ x, y }));
+      await sleep(280);
+      return { ok: true, at: { x, y } };
     case 'click':
-      await mouseMove(x, y);
-      await clickSimple('left');
+      await ps(mouseScript({ x, y, down: LMB_DOWN, up: LMB_UP }));
       return { ok: true, at: { x, y } };
     case 'dblclick':
-      await mouseMove(x, y);
-      await clickSimple('left');
-      await sleep(70);
-      await clickSimple('left');
+      await ps(mouseScript({ x, y, down: LMB_DOWN, up: LMB_UP, dbl: true }));
       return { ok: true, at: { x, y } };
     case 'rightclick':
-      await mouseMove(x, y);
-      await clickSimple('right');
+      await ps(mouseScript({ x, y, down: RMB_DOWN, up: RMB_UP }));
       return { ok: true, at: { x, y } };
+    case 'drag': {
+      const x2 = clampCoord(args.x2);
+      const y2 = clampCoord(args.y2);
+      if (x == null || y == null || x2 == null || y2 == null) {
+        return { ok: false, error: 'drag için x,y,x2,y2 gerekli' };
+      }
+      await ps(dragScript(x, y, x2, y2));
+      return { ok: true, from: { x, y }, to: { x2, y2 } };
+    }
+    case 'focus': {
+      const title = String(args.title || args.text || '').trim().slice(0, 120);
+      if (!title) return { ok: false, error: 'focus için title gerekli' };
+      const out = await ps(focusScript(Buffer.from(title, 'utf8').toString('base64')));
+      if (out.includes('ok')) return { ok: true, focused: true, title };
+      if (out.includes('noforeground')) return { ok: true, focused: false, title, note: 'pencere bulundu ama öne getirilemedi' };
+      return { ok: false, error: `pencere bulunamadı: ${title}` };
+    }
     case 'type': {
       const text = String(args.text ?? '').slice(0, 2000);
       if (!text) return { ok: false, error: 'boş metin' };
-      /* Add-Type SendInput tabanlı Unicode typer */
       await ps(buildTyperScript(text));
       return { ok: true, chars: text.length };
     }
@@ -87,11 +236,7 @@ async function act(op, args = {}) {
     case 'scroll': {
       const dy = Math.max(-10, Math.min(10, Math.round(Number(args.dy) || 0)));
       if (!dy) return { ok: false, error: 'dy gerekli (-10..10)' };
-      await mouseMove(x || 640, y || 360);
-      const clicks = Math.abs(dy) * 3;
-      for (let i = 0; i < clicks; i++) {
-        await wheel(dy > 0 ? 1 : -1); // pozitif dy = aşağı
-      }
+      await ps(wheelScript(x || 640, y || 360, dy));
       return { ok: true, dy };
     }
     default:
@@ -105,38 +250,20 @@ function sleep(ms) {
 
 /* ---------- PowerShell snippet üreticileri ---------- */
 
-const MOUSE_MOVE_TPL = `
-Add-Type @"
-using System;
-using System.Runtime.InteropServices;
-public class BM {
-  [DllImport("user32.dll")] public static extern bool SetCursorPos(int X, int Y);
-}
-"@
-[BM]::SetCursorPos(%%X%%, %%Y%%) | Out-Null
-`;
-
-const WHEEL_TPL = `
-Add-Type @"
-using System;
-using System.Runtime.InteropServices;
-public class BW {
-  [DllImport("user32.dll")] public static extern void mouse_event(uint dwFlags, uint dx, uint dy, uint dwData, UIntPtr dwExtraInfo);
-}
-"@
-[BW]::mouse_event(0x0800, 0, 0, %%DELTA%%, [UIntPtr]::Zero)
-`;
-
-/* Unicode güvenli yazım: SendInput yerine pano + Ctrl+V fallback'u en sağlamı.
-   Panoyu geri yüklemek yerine tek seferlik kullanıp bırakıyoruz (hız öncelik). */
+/* Unicode güvenli yazım: pano köprüsü. Panoyu ÖNCE kaydet, yapıştırdıktan
+   SONRA geri koy — kullanıcının panosu kaybolmaz. */
 function buildTyperScript(text) {
   const b64 = Buffer.from(text, 'utf16le').toString('base64');
   return `
 $t = [System.Text.Encoding]::Unicode.GetString([Convert]::FromBase64String("${b64}"))
 Add-Type -AssemblyName System.Windows.Forms
+$prev = $null
+try { $prev = [System.Windows.Forms.Clipboard]::GetText() } catch {}
 [System.Windows.Forms.Clipboard]::SetText($t)
 Start-Sleep -Milliseconds 80
 [System.Windows.Forms.SendKeys]::SendWait("^v")
+Start-Sleep -Milliseconds 150
+if ($prev -ne $null -and $prev -ne "") { try { [System.Windows.Forms.Clipboard]::SetText($prev) } catch {} }
 `;
 }
 
@@ -145,18 +272,19 @@ function buildKeyScript(combo) {
   const map = {
     enter: '{ENTER}', tab: '{TAB}', esc: '{ESC}', escape: '{ESC}',
     backspace: '{BACKSPACE}', delete: '{DELETE}', del: '{DELETE}',
+    insert: '{INSERT}', ins: '{INSERT}', capslock: '{CAPSLOCK}',
     home: '{HOME}', end: '{END}', pgup: '{PGUP}', pgdn: '{PGDN}',
     up: '{UP}', down: '{DOWN}', left: '{LEFT}', right: '{RIGHT}',
-    space: ' ', win: '^({ESC})',
+    space: ' ',
   };
   let out = '';
   const parts = String(combo).toLowerCase().split('+').map((p) => p.trim());
   let mods = '';
   for (const p of parts) {
-    if (p === 'ctrl') mods += '^';
+    if (p === 'ctrl' || p === 'control') mods += '^';
     else if (p === 'alt') mods += '%';
     else if (p === 'shift') mods += '+';
-    else if (p === 'win') out += ''; // win ayrı ele
+    else if (p === 'win') mods += '^{ESC}';
     else if (/^f\d{1,2}$/.test(p)) out += '{' + p.toUpperCase() + '}';
     else if (map[p]) out += map[p];
     else out += p.slice(0, 1).toUpperCase(); // tek harf/tuş
@@ -171,30 +299,50 @@ Add-Type -AssemblyName System.Windows.Forms
 }
 
 async function mouseMove(x, y) {
-  await ps(MOUSE_MOVE_TPL.replace(/%%X%%/g, String(x)).replace(/%%Y%%/g, String(y)));
+  await ps(mouseScript({ x: clampCoord(x), y: clampCoord(y) }));
 }
 
-/* down+up tek script'te — karışık replace zinciri yerine bu kullanılır */
+/* down+up tek script'te */
 async function clickSimple(button) {
-  const down = button === 'right' ? 0x0008 : 0x0002;
-  const up = button === 'right' ? 0x0010 : 0x0004;
-  await ps(`
-Add-Type @"
-using System;
-using System.Runtime.InteropServices;
-public class BC2 {
-  [DllImport("user32.dll")] public static extern void mouse_event(uint dwFlags, uint dx, uint dy, uint dwData, UIntPtr dwExtraInfo);
+  await ps(mouseScript({ down: button === 'right' ? RMB_DOWN : LMB_DOWN, up: button === 'right' ? RMB_UP : LMB_UP }));
 }
-"@
-[BC2]::mouse_event(${down}, 0, 0, 0, [UIntPtr]::Zero)
-Start-Sleep -Milliseconds 45
-[BC2]::mouse_event(${up}, 0, 0, 0, [UIntPtr]::Zero)
-`);
+
+/* ---------- GÖRSEL DOĞRULAMA (verify) ----------
+   "Aksiyon işe yaradı mı?" sorusunu ucuz bir görsel parmak iziyle yanıtlar:
+   kareyi 8x6 hücreye bölüp her hücrenin ortalama parlaklığını çıkarır.
+   İki imza arasındaki fark > eşik olan hücre oranı = değişim oranı.
+   Animasyon/anti-alias gürültüsüne toleranslıdır (eşik 8/255). */
+function bitmapSignature(bmp, w, h) {
+  try {
+    if (!bmp || !w || !h) return null;
+    const cells = [];
+    const cw = Math.max(1, Math.floor(w / 8));
+    const ch = Math.max(1, Math.floor(h / 6));
+    for (let cy = 0; cy < 6; cy++) {
+      for (let cx = 0; cx < 8; cx++) {
+        let sum = 0;
+        let n = 0;
+        for (let y = cy * ch; y < Math.min(h, (cy + 1) * ch); y += 2) {
+          for (let x = cx * cw; x < Math.min(w, (cx + 1) * cw); x += 2) {
+            const o = (y * w + x) * 4;
+            sum += 0.114 * bmp[o] + 0.587 * bmp[o + 1] + 0.299 * bmp[o + 2];
+            n++;
+          }
+        }
+        cells.push(n ? sum / n : 0);
+      }
+    }
+    return cells;
+  } catch {
+    return null;
+  }
 }
 
-async function wheel(dir) {
-  const delta = dir < 0 ? -240 : 240; // WHEEL_DELTA=120 katları; negatif=yukarı görüntüde aşağı kayar bazı app'lerde
-  await ps(WHEEL_TPL.replace(/%%DELTA%%/g, String(delta)));
+function signatureDiff(a, b, thresh = 8) {
+  if (!a || !b || a.length !== b.length || !a.length) return null;
+  let changed = 0;
+  for (let i = 0; i < a.length; i++) if (Math.abs(a[i] - b[i]) > thresh) changed++;
+  return changed / a.length;
 }
 
-module.exports = { act, screenSize, clickSimple, mouseMove };
+module.exports = { act, screenSize, scaleArgs, bitmapSignature, signatureDiff, clickSimple, mouseMove };

package/src/agent/engine.js

@@ -155,11 +155,12 @@ const PERM_TOOL_SETS = {
     'web_search', 'http_fetch', 'webfetch', 'deep_search',
     'browser_open', 'browser_read', 'browser_snapshot', 'browser_screenshot',
     'browser_click', 'browser_type', 'browser_press', 'browser_scroll', 'browser_select',
+    'browser_wait',
     'ocr_read', 'tool_request',
   ]),
   read: new Set([
     'web_search', 'http_fetch', 'webfetch', 'deep_search',
-    'browser_open', 'browser_read', 'browser_snapshot',
+    'browser_open', 'browser_read', 'browser_snapshot', 'browser_wait',
     'list_dir', 'read_file', 'grep', 'glob',
     'git_diff_review', 'repo_map', 'repo_symbols', 'xlsx_read',
     'tool_request',
@@ -191,6 +192,7 @@ const CEO_EXEC_TOOLS = new Set([
   'web_search', 'http_fetch', 'webfetch', 'deep_search',
   'browser_open', 'browser_read', 'browser_screenshot', 'browser_snapshot',
   'browser_click', 'browser_type', 'browser_press', 'browser_scroll', 'browser_select',
+  'browser_wait',
   'computer_look', 'computer_act',
   'ocr_read',
   'channel_send', // dış kişilere mesaj: CEO devreder, kendisi atmaz
@@ -2125,6 +2127,7 @@ class Engine {
         [
           '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 — 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.',
+          'TERMİNAL DİSİPLİNİ: run_command komutları ETKİLEŞİMSİZDİR — REPL/editör/pager (`node`, `python`, `vi`, `notepad`) ve girdi bekleyen komutlar (mesajsız `git commit`, -y\'siz `npm init`, BatchMode\'suz `ssh`) otomatik reddedilir ya da kilitlenmeden kesilir. Etkileşimsiz bayrakları kullan (-y, -m, --yes, --accept-*), uzun betikleri dosyaya yazıp çalıştır. Uzun süreli sunucuları (`npm run dev/start`, `vite`, `uvicorn`, `flask run`...) run_command ile BAŞLATMA — 10 sn içinde kesilir; Sandbox\'ta panel_run, diğer yerlerde arka plan (`Start-Process ... -RedirectStandardOutput log.txt`) kullan, çıktıyı sonra dosyadan oku.',
           '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).',
           'İLK MESAJ (channel_send): kullanıcı "X kişiye yaz / haber ver / duyur" derse channel_send ile SEN ilk mesajı at — karşıdan mesaj gelmesini BEKLEME. Yalnız allow listteki kişiler hedeflenebilir: isim (kısmi), telefon numarası, Telegram/Discord ID, @kullanıcı adı, "sahip" ya da "all". Kişi listede yoksa gönderme, kullanıcıya söyle. Telegram/Discord\'da karşı taraf bota daha önce hiç yazmadıysa gönderim başarısız olabilir; sonucu dürüstçe bildir.',
                     '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.',
@@ -3711,6 +3714,7 @@ class Engine {
       `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` +
+      `TERMİNAL DİSİPLİNİ: komutlar ETKİLEŞİMSİZ koşar — REPL/editör/pager ve girdi bekleyen komutlar (mesajsız git commit, -y'siz npm init) reddedilir/kesilir; -y, -m, --yes, --accept-* bayraklarını kullan. Uzun süreli sunucuları run_command ile BAŞLATMA (10 sn'de kesilir) — arka planda başlat (panel_run ya da Start-Process + çıktıyı log dosyasına yönlendir).\n` +
       (proj ? `PROJE TALİMATLARI (workspace AGENTS/CLAUDE/CONTEXT — daima uy):\n${proj}\n` : '') +
       `HIZ KURALLARI:\n` +
       `- TOOL İSTEĞİ (CEPHANE): ihtiyacın olan araç yoksa/bozuksa tool_request ile TOOL botuna yazdır (asenkron: istek anında döner, Tool botu arka planda yazar; araç doğrulanınca tool__<ad> olarak anında çağrılır, rapor sohbete düşer); küçük aracı skill("tool-yazma") ile kendin de yaz ve run_command ile doğrula.\n` +
@@ -5139,7 +5143,8 @@ const skills = require('./skills');
         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, { sessionId });
+        /* OCR düz görüntü ister — ref etiketleri metni kirletmesin */
+        const shot = await this.browser.screenshot(signal, { sessionId, annotate: false });
         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') {
@@ -5147,7 +5152,8 @@ const skills = require('./skills');
         if (!this.computer || typeof this.computer.look !== 'function') {
           return { ok: false, error: 'ekran erişimi yok' };
         }
-        const shot = await this.computer.look();
+        /* OCR düz görüntü ister — ızgara/imleç etiketleri OCR'a girmesin */
+        const shot = await this.computer.look({ annotate: false });
         image = typeof shot === 'string' ? shot : (shot && (shot.image || shot.dataUrl)) || null;
       } else {
         const abs = path.isAbsolute(src) ? src : path.join(this.workspace, src);
@@ -5737,12 +5743,14 @@ const skills = require('./skills');
           return JSON.stringify({ ok: false, error: 'ekran erişimi yok' });
         }
         emitSafe(this, sessionId, { type: 'status', status: 'ekrana bakıyor' });
-        const shot = await this.computer.look();
+        const shot = await this.computer.look({ annotate: true });
         if (!shot) return JSON.stringify({ ok: false, error: 'ekran görüntüsü alınamadı' });
         /* görsel sonraki tura vision mesajı olarak enjekte edilir */
         return JSON.stringify({
           ok: true,
-          note: 'ekran görüntüsü alındı — görsel aşağıda; koordinatlar 1280x720 tabanlı',
+          note:
+            'ekran görüntüsü alındı — görsel aşağıda; 128px ızgara + kırmızı imleç işareti çizili (etiketli koordinatlar görüntü tabanlı). ' +
+            'computer_act koordinatları 1280px görüntü tabanlı alır ve gerçek ekrana otomatik çevirir',
           __injectImage: shot,
         });
       }
@@ -5817,6 +5825,13 @@ const skills = require('./skills');
         const r = await this.browser.act(name.slice(8), args, signal, { sessionId });
         return JSON.stringify(r);
       }
+      if (name === 'browser_wait') {
+        if (!this.browser || typeof this.browser.wait !== 'function') {
+          return JSON.stringify({ ok: false, error: 'dahili tarayıcı kullanılamıyor' });
+        }
+        const r = await this.browser.wait(args || {}, signal, { sessionId });
+        return JSON.stringify(r);
+      }
       /* Beast Apps: app__<id>__<tool> → apps host'a dispatch */
       if (String(name).startsWith('app__')) {
         return JSON.stringify(await apps.call(name, args || {}, signal));
@@ -6403,7 +6418,7 @@ const TOOLS = [
     function: {
       name: 'computer_look',
       description:
-        'Take a screenshot of the user\u2019s screen and receive it as an image. Use before computer_act to see the GUI; coordinates are on a 1280x720 basis.',
+        'Take a screenshot of the user\u2019s screen and receive it as an image. Use before computer_act to see the GUI; coordinates are on a 1280px-wide image basis — computer_act converts them to real screen coordinates automatically (multi-monitor offsets included).',
       parameters: { type: 'object', properties: {} },
     },
   },
@@ -6412,19 +6427,23 @@ const TOOLS = [
     function: {
       name: 'computer_act',
       description:
-        'Control mouse/keyboard on the user\u2019s Windows desktop (GUI automation). Ops: click{x,y}, dblclick{x,y}, rightclick{x,y}, move{x,y}, type{text}, key{combo e.g. "ctrl+s","enter","alt+tab"}, scroll{x,y,dy}. Look first with computer_look, act step by step, look again after acting.',
+        'Control mouse/keyboard on the user\u2019s Windows desktop (GUI automation). Ops: click{x,y}, dblclick{x,y}, rightclick{x,y}, move{x,y}, hover{x,y} (opens hover menus), drag{x,y,x2,y2}, focus{title} (bring a window whose title contains the text to front), type{text}, key{combo e.g. "ctrl+s","enter","alt+tab"}, scroll{x,y,dy}. Coordinates are 1280px-wide image based (as seen in computer_look) — converted automatically. After click/type/key/drag the response reports changed/changeRatio (visual verification); if changed:false a warning means the action probably had no effect — do NOT assume success, re-check with computer_look / focus the right window. Look first with computer_look, act step by step, look again after acting.',
       parameters: {
         type: 'object',
         properties: {
           op: {
             type: 'string',
-            enum: ['click', 'dblclick', 'rightclick', 'move', 'type', 'key', 'scroll'],
+            enum: ['click', 'dblclick', 'rightclick', 'move', 'hover', 'drag', 'focus', 'type', 'key', 'scroll'],
           },
           x: { type: 'number' },
           y: { type: 'number' },
+          x2: { type: 'number', description: 'for op=drag: end x' },
+          y2: { type: 'number', description: 'for op=drag: end y' },
+          title: { type: 'string', description: 'for op=focus: window title substring (case-insensitive)' },
           text: { type: 'string', description: 'for op=type (max 2000 chars)' },
           combo: { type: 'string', description: 'for op=key: "enter", "ctrl+s", "alt+tab", "win"' },
           dy: { type: 'number', description: 'for op=scroll: positive = down (-10..10)' },
+          verify: { type: 'boolean', description: 'set false to skip the visual change check' },
         },
         required: ['op'],
       },
@@ -6537,12 +6556,13 @@ const TOOLS = [
     function: {
       name: 'browser_click',
       description:
-        'Click an element in the built-in browser. Prefer ref from the latest snapshot (e.g. {"ref":3}); CSS selector or text=X also accepted. The response includes a FRESH snapshot with new refs — continue with those directly instead of calling browser_snapshot again.',
+        'Click an element in the built-in browser. Prefer ref from the latest snapshot (e.g. {"ref":3}); CSS selector or text=X also accepted. The response includes a FRESH snapshot with new refs — continue with those directly instead of calling browser_snapshot again. It also reports changed/changeRatio: if changed is false the click probably had no effect (stale ref/hidden element) — take a fresh snapshot and retry, do NOT assume success.',
       parameters: {
         type: 'object',
         properties: {
           ref: { type: 'number', description: 'element number from browser_snapshot' },
           selector: { type: 'string', description: 'CSS selector or text=X alternative' },
+          verify: { type: 'boolean', description: 'set false to skip the visual change check' },
         },
       },
     },
@@ -6552,7 +6572,7 @@ const TOOLS = [
     function: {
       name: 'browser_type',
       description:
-        'Type text into an input/textarea/contenteditable in the built-in browser (prefer ref). Set submit=true to press Enter afterwards. Date/time fields (input type=date/time/month/datetime-local) are set PROGRAMMATICALLY — just send the date as text in any common format ("2026-03-15", "15.03.2026", "15 Mart 2026"); do NOT click the calendar popup. The response includes a FRESH snapshot with new refs.',
+        'Type text into an input/textarea/contenteditable in the built-in browser (prefer ref). Set submit=true to press Enter afterwards. Date/time fields (input type=date/time/month/datetime-local) are set PROGRAMMATICALLY — just send the date as text in any common format ("2026-03-15", "15.03.2026", "15 Mart 2026"); do NOT click the calendar popup. The response includes a FRESH snapshot with new refs and changed/changeRatio (visual verification).',
       parameters: {
         type: 'object',
         properties: {
@@ -6560,6 +6580,7 @@ const TOOLS = [
           selector: { type: 'string' },
           text: { type: 'string' },
           submit: { type: 'boolean' },
+          verify: { type: 'boolean', description: 'set false to skip the visual change check' },
         },
         required: ['text'],
       },
@@ -6570,12 +6591,13 @@ const TOOLS = [
     function: {
       name: 'browser_press',
       description:
-        'Press a key (Enter, Tab, Escape, ArrowDown…) on the focused element in the built-in browser; optionally focus a ref first. The response includes a FRESH snapshot with new refs.',
+        'Press a key (Enter, Tab, Escape, ArrowDown…) on the focused element in the built-in browser; optionally focus a ref first. The response includes a FRESH snapshot with new refs and changed/changeRatio (visual verification).',
       parameters: {
         type: 'object',
         properties: {
           key: { type: 'string' },
           ref: { type: 'number', description: 'optional element to focus first' },
+          verify: { type: 'boolean', description: 'set false to skip the visual change check' },
         },
         required: ['key'],
       },
@@ -6602,18 +6624,38 @@ const TOOLS = [
     function: {
       name: 'browser_select',
       description:
-        'Pick an <option> of a dropdown (<select>) in the built-in browser by value/text (prefer ref). The response includes a FRESH snapshot with new refs. For CUSTOM (JS) dropdowns that are not <select>, click the trigger, then click the [role=option] ref from the snapshot (popups are listed first).',
+        'Pick an <option> of a dropdown (<select>) in the built-in browser by value/text (prefer ref). The response includes a FRESH snapshot with new refs and changed/changeRatio (visual verification). For CUSTOM (JS) dropdowns that are not <select>, click the trigger, then click the [role=option] ref from the snapshot (popups are listed first).',
       parameters: {
         type: 'object',
         properties: {
           ref: { type: 'number' },
           selector: { type: 'string' },
           value: { type: 'string' },
+          verify: { type: 'boolean', description: 'set false to skip the visual change check' },
         },
         required: ['value'],
       },
     },
   },
+  {
+    type: 'function',
+    function: {
+      name: 'browser_wait',
+      description:
+        'Wait in the built-in browser until a condition is met (or timeout): selector appears (or disappears with gone:true), visible text appears, or a ref becomes valid; ms only = fixed sleep. Use this on SPAs / slow pages AFTER an action instead of blind retries — then act on the fresh snapshot. Timeout default 10000ms (max 30000).',
+      parameters: {
+        type: 'object',
+        properties: {
+          selector: { type: 'string', description: 'CSS selector to wait for' },
+          text: { type: 'string', description: 'visible page text/substring to wait for' },
+          ref: { type: 'number', description: 'ref from snapshot that should become valid' },
+          gone: { type: 'boolean', description: 'wait until selector/text/ref DISAPPEARS instead' },
+          ms: { type: 'number', description: 'fixed wait in ms (max 10000); used alone or as extra delay' },
+          timeout_ms: { type: 'number', description: 'condition timeout, default 10000 (max 30000)' },
+        },
+      },
+    },
+  },
 ];
 
 /* ---------- GÖREV (TODO) ID + GERİ ALMA SİSTEMİ ----------

package/src/agent/opencode/toolmap.js

@@ -60,7 +60,9 @@ After ensuring proper quoting, execute the command.
     - If the commands depend on each other and must run sequentially, avoid '&&' in this shell because Windows PowerShell (5.1) does not support it. Use PowerShell conditionals such as \`cmd1; if ($?) { cmd2 }\` when later commands must depend on earlier success.
     - DO NOT use newlines to separate commands (newlines are ok in quoted strings)
   - The shell is PERSISTENT: working directory and environment variables are preserved between calls.
-  - Commands run in Windows PowerShell (5.1).`;
+  - Commands run in Windows PowerShell (5.1).
+  - Commands are NON-INTERACTIVE: no REPLs/editors/pagers (\`node\`, \`python\`, \`vi\`, \`notepad\`), no input-waiting commands (\`git commit\` without -m, \`npm init\` without -y, \`ssh\` without BatchMode). They are rejected or aborted to avoid stalling. Use non-interactive flags (-y, -m, --yes) and write scripts to files instead.
+  - NEVER start long-running servers (npm run dev/start, vite, uvicorn, flask run...) with this tool — they are aborted after 10s. Use panel_run (run panel) or a background process (Start-Process with output redirected to a log file).`;
 }
 
 /* opencode tool şemaları — Schema.Struct karşılığı JSON Schema'lar */