beast-agent 0.27.0 → 0.28.0

package/src/renderer/renderer.js

@@ -383,6 +383,17 @@ function addErrorBubble(text) {
   scrollDown(true);
 }
 
+/* ajan durduruldu/iptal edildi — SEBEP zorunlu, sohbete sönük not olarak düşer */
+function addStopNote(reason) {
+  streamEl = null;
+  showEmpty(false);
+  const div = document.createElement('div');
+  div.className = 'msg msg-sys';
+  div.textContent = '\u23F9 Durduruldu — sebep: ' + String(reason || 'sebep belirtilmedi');
+  els.msgs.appendChild(div);
+  scrollDown(true);
+}
+
 /* ---------------- tool cards ---------------- */
 /* Ard arda gelen araç kartları TEK kutuda toplanır (.tool-box): çalışırken
    lacivert outline döner, gövde max 420px scroll'lu. Grup; tool_calls İÇEREN
@@ -738,12 +749,30 @@ async function refreshFalloutPane() {
   renderFalloutPane();
 }
 
-/* Web Arama sekmesi: TinyFish (zincirin başı) + Exa API anahtarı (maskeli) */
+/* Web Arama sekmesi: TinyFish anahtarı + Obscura (kurulum/aktiflik) + arama sırası */
 async function renderWebSearchPane() {
   const pane = $('#tab-websearch');
   if (!pane) return;
   const tf = await beast.tinyfishGet().catch(() => ({ set: false, masked: '' }));
   pane.innerHTML =
+    '<h2>' + _t('ws_h2') + '</h2>' +
+    '<div class="sub">' + _t('ws_sub') + '</div>' +
+    /* --- Obscura --- */
+    '<div class="divider"></div>' +
+    '<h2>' + _t('oc_h2') + '</h2>' +
+    '<div class="sub">' + _t('oc_sub') + '</div>' +
+    '<div id="ocStatus" class="sub" style="text-align:left;margin-top:8px"></div>' +
+    '<label class="mem-label" style="display:flex;align-items:center;gap:8px;cursor:pointer">' +
+    '<input id="ocEnabled" type="checkbox" style="width:auto" /> <span>' + _t('oc_enabled') + '</span></label>' +
+    '<div class="form-grid" style="grid-template-columns:auto auto;gap:8px;margin-top:10px">' +
+    '<button id="ocInstall" class="btn">' + _t('oc_install') + '</button></div>' +
+    /* --- Arama sırası --- */
+    '<div class="divider"></div>' +
+    '<h2>' + _t('so_h2') + '</h2>' +
+    '<div class="sub">' + _t('so_sub') + '</div>' +
+    '<div id="soList" style="margin-top:10px"></div>' +
+    /* --- TinyFish --- */
+    '<div class="divider"></div>' +
     '<h2>' + _t('tf_h2') + '</h2>' +
     '<div class="sub">' + _t('tf_sub') + '</div>' +
     '<div id="tfStatus" class="sub" style="text-align:left;margin-top:8px"></div>' +
@@ -751,26 +780,80 @@ async function renderWebSearchPane() {
     '<input id="tfKeyInp" class="inp" type="password" placeholder="tf_..." autocomplete="new-password" spellcheck="false" />' +
     '<div class="form-grid" style="grid-template-columns:auto auto;gap:8px;margin-top:8px">' +
     '<button id="tfSave" class="btn">' + _t('ws_save') + '</button>' +
-    '<button id="tfClear" class="btn ghost">' + _t('ws_clear') + '</button></div>' +
-    '<div class="divider"></div>' +
-    '<h2>' + _t('ws_h2') + '</h2>' +
-    '<div class="sub">' + _t('ws_sub') + '</div>' +
-    '<div id="exaStatus" class="sub" style="text-align:left;margin-top:10px"></div>' +
-    '<label class="mem-label">' + _t('ws_exa_label') + '</label>' +
-    '<input id="exaKeyInp" class="inp" type="password" placeholder="' + _t('ws_exa_ph') + '" autocomplete="new-password" spellcheck="false" />' +
-    '<div class="form-grid" style="grid-template-columns:auto auto;gap:8px;margin-top:8px">' +
-    '<button id="exaSave" class="btn">' + _t('ws_save') + '</button>' +
-    '<button id="exaClear" class="btn ghost">' + _t('ws_clear') + '</button></div>' +
-    '<div class="sub" style="margin-top:8px">' + _t('ws_note') + '</div>';
-  const st = $('#exaStatus');
-  const setExaSt = (r) => {
-    st.textContent = r.set ? _t('ws_status_set') + r.masked : _t('ws_status_unset');
-  };
+    '<button id="tfClear" class="btn ghost">' + _t('ws_clear') + '</button></div>';
+
+  /* --- Obscura durumu --- */
+  const ocSt = $('#ocStatus');
+  const ocChk = $('#ocEnabled');
+  const ocBtn = $('#ocInstall');
+  const oc = await beast.obscuraGet().catch(() => ({ installed: false, enabled: true, dir: '' }));
+  ocChk.checked = oc.enabled !== false;
+  ocSt.textContent = oc.installed ? _t('oc_status_ok') : _t('oc_status_missing');
+  ocChk.addEventListener('change', async () => {
+    await beast.obscuraSetEnabled(ocChk.checked).catch(() => {});
+    toast(ocChk.checked ? _t('oc_on_toast') : _t('oc_off_toast'));
+  });
+  ocBtn.addEventListener('click', async () => {
+    ocBtn.disabled = true;
+    ocBtn.textContent = _t('oc_installing');
+    ocSt.textContent = _t('oc_installing');
+    const r = await beast.obscuraInstall().catch(() => ({ ok: false, error: 'hata' }));
+    ocBtn.disabled = false;
+    ocBtn.textContent = _t('oc_install');
+    ocSt.textContent = r && r.ok ? _t('oc_status_ok') : _t('oc_install_fail') + (r && r.error ? r.error : '?');
+    toast(r && r.ok ? _t('oc_installed_toast') : _t('oc_install_fail') + (r && r.error ? r.error : '?'));
+  });
+
+  /* --- Arama sırası --- */
+  const soBox = $('#soList');
+  let rows = [];
+  const soRes = await beast.searchOrderGet().catch(() => ({ chain: [] }));
+  rows = (soRes && Array.isArray(soRes.chain) && soRes.chain.length) ? soRes.chain.map((x) => ({ id: x.id, on: x.on !== false })) : [];
+  const engName = (id) => _t('so_engine_' + id) || id;
+  function renderRows() {
+    soBox.innerHTML = '';
+    rows.forEach((row, i) => {
+      const el = document.createElement('div');
+      el.className = 'so-row' + (row.on ? '' : ' off');
+      el.style.cssText = 'display:flex;align-items:center;gap:8px;padding:6px 8px;border:1px solid var(--border);border-radius:8px;margin-bottom:6px';
+      el.innerHTML =
+        '<span class="so-idx" style="min-width:18px;color:var(--muted);font-size:12px">' + (i + 1) + '.</span>' +
+        '<input type="checkbox" class="so-chk" style="width:auto" ' + (row.on ? 'checked' : '') + ' />' +
+        '<span style="flex:1">' + escapeHtml(engName(row.id)) + '</span>' +
+        '<button class="so-up" title="Yukarı" style="width:auto;padding:2px 8px">↑</button>' +
+        '<button class="so-down" title="Aşağı" style="width:auto;padding:2px 8px">↓</button>';
+      el.querySelector('.so-chk').addEventListener('change', async (e) => {
+        row.on = e.target.checked;
+        el.classList.toggle('off', !row.on);
+        await saveOrder();
+      });
+      el.querySelector('.so-up').addEventListener('click', async () => {
+        if (i === 0) return;
+        [rows[i - 1], rows[i]] = [rows[i], rows[i - 1]];
+        renderRows();
+        await saveOrder();
+      });
+      el.querySelector('.so-down').addEventListener('click', async () => {
+        if (i >= rows.length - 1) return;
+        [rows[i + 1], rows[i]] = [rows[i], rows[i + 1]];
+        renderRows();
+        await saveOrder();
+      });
+      soBox.appendChild(el);
+    });
+  }
+  async function saveOrder() {
+    const r = await beast.searchOrderSet(rows).catch(() => null);
+    if (r && r.ok) toast(_t('so_saved_toast'));
+    else toast(_t('ws_fail_toast'));
+  }
+  if (rows.length) renderRows();
+
+  /* --- TinyFish --- */
   const tfSt = $('#tfStatus');
   const setTfSt = (r) => {
     tfSt.textContent = r.set ? _t('tf_status_set') + r.masked : _t('tf_status_unset');
   };
-  setExaSt(await beast.exaGet().catch(() => ({ set: false, masked: '' })));
   setTfSt(tf);
   $('#tfSave').addEventListener('click', async () => {
     const v = $('#tfKeyInp').value.trim();
@@ -790,24 +873,6 @@ async function renderWebSearchPane() {
     setTfSt({ set: false, masked: '' });
     toast(_t('tf_cleared_toast'));
   });
-  $('#exaSave').addEventListener('click', async () => {
-    const v = $('#exaKeyInp').value.trim();
-    if (!v) { toast(_t('ws_empty_toast')); return; }
-    const rr = await beast.exaSet(v).catch(() => null);
-    $('#exaKeyInp').value = '';
-    if (rr && rr.set) {
-      setExaSt(rr);
-      toast(_t('ws_saved_toast'));
-    } else {
-      toast(_t('ws_fail_toast'));
-    }
-  });
-  $('#exaClear').addEventListener('click', async () => {
-    await beast.exaClear().catch(() => {});
-    $('#exaKeyInp').value = '';
-    setExaSt({ set: false, masked: '' });
-    toast(_t('ws_cleared_toast'));
-  });
 }
 
 async function renderProviderPane() {
@@ -3447,7 +3512,7 @@ function renderAgentRail() {
       `<span class="ag-dot"></span>` +
       `<span class="sess-title">${escapeHtml(j.title)}</span>` +
       (j.code ? `<span class="sess-code" title="Oturum kodu">${escapeHtml(j.code)}</span>` : ``) +
-       `<span class="rj-time">${j.status === 'running' ? when + ' · ' + agentTimerHtml(j.startedAt) + ' · ' + _t('ag_working') : (agStText(j.status) === _t('ag_st_done') ? '\u2713' : (agStText(j.status) || j.status))}</span>` +
+       `<span class="rj-time">${j.status === 'running' ? when + ' · ' + agentTimerHtml(j.startedAt) + ' · ' + _t('ag_working') : (agStText(j.status) === _t('ag_st_done') ? '\u2713' : (agStText(j.status) || j.status) + (j.status === 'aborted' && j.error ? ' — ' + escapeHtml(String(j.error).slice(0, 70)) : ''))}</span>` +
        (j.status === 'running'
          ? `<button class="rj-cancel" title="${_t('ag_cancel')}">×</button>`
          : `<button class="rj-cancel" title="${_t('ag_delete')}"><svg viewBox="0 0 24 24" width="12" height="12" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M3 6h18"/><path d="M8 6V4a1 1 0 0 1 1-1h6a1 1 0 0 1 1 1v2"/><path d="M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6"/><path d="M10 11v6M14 11v6"/></svg></button>`) +
@@ -3577,7 +3642,7 @@ function renderAgentsPane() {
       `<div class="ag-head">` +
       `<span class="ag-dot"></span>` +
       `<span class="ag-title">${escapeHtml(j.title)}</span>` +
-       `<span class="ag-st">${agStText(j.status) || j.status}</span>` +
+       `<span class="ag-st" title="${j.error ? escapeHtml(String(j.error)) : ''}">${agStText(j.status) || j.status}</span>` +
       `<span class="ag-time">${when}${j.status === 'running' ? ' · ' + agentTimerHtml(j.startedAt) : j.endedAt ? ` · ${fmtAgo(j.endedAt)}` : ''}</span>` +
       (j.status === 'running'
          ? `<button class="ag-btn cancel" title="${_t('ag_cancel')}">${_t('ag_cancel')}</button>`
@@ -3764,6 +3829,8 @@ function onEvent(ev) {
       break;
     case 'done':
       closeChatToolGroup();
+      /* iptal/durdurma sebebini SOHBETE yaz — sebepsiz durdurma yok */
+      if (ev.aborted) addStopNote(ev.reason);
       setBusy(false);
       setStatus(''); /* son durum balonu ("düşünüyor…" vb.) yapışmasın */
       /* cevabın SONU görünsün: markdown son render sonrası iki kez en alta kilitle */
@@ -6103,7 +6170,8 @@ function bcIngest(ev) {
       bcFlushStream();
       bcCloseToolGroup();
       bcSetBusy(false);
-      bcLine('t-dim', '(tamamlandı)');
+      /* iptal/durdurma SEBEBİ panelde de görünür */
+      bcLine(ev.aborted ? 't-err' : 't-dim', ev.aborted ? '[durduruldu — sebep: ' + (ev.reason || 'sebep belirtilmedi') + ']' : '(tamamlandı)');
       bcRefreshPreview();
       if (ideModeOn() && els.bcInput) els.bcInput.focus();
       break;

package/src/renderer/style.css

@@ -759,6 +759,17 @@ body.term-open #settingsOverlay { right: var(--tw, 520px); }
   padding: 10px 14px;
 }
 
+/* durdurma/iptal notu: sebep zorunlu — nötr, sönük ton */
+.msg-sys {
+  border: 1px dashed var(--border);
+  background: var(--panel);
+  color: var(--muted);
+  border-radius: 10px;
+  padding: 8px 12px;
+  font-size: 12.5px;
+  word-break: break-word;
+}
+
 /* markdown */
 .md p { margin: 0 0 8px; }
 .md p:last-child { margin-bottom: 0; }

package/tests/bg-jobs.test.js

@@ -271,18 +271,86 @@ test('#5 eşzamanlılık limiti: fazlası kuyrukta bekler, slot boşalınca FIFO
   assert.deepEqual(st, ['queued', 'queued', 'running', 'running']);
   assert.strictEqual(sent.length, 2);
 
-  /* slot açılır → sıradaki queued iş running olur ve gönderilir */
+  /* slot açılır → sıradaki queued iş running olur ve gönderilir.
+     _bgFinish('aborted') artık üst sohbete [ARKA PLAN İPTAL + SEBEP] raporu da düşürür. */
   eng._bgFinish(ids[0], 'aborted');
   await sleep(30);
   const queued = [...eng._bgJobs.values()].filter((j) => j.status === 'queued').length;
   const running = [...eng._bgJobs.values()].filter((j) => j.status === 'running').length;
   assert.strictEqual(queued, 1);
   assert.strictEqual(running, 2);
-  assert.strictEqual(sent.length, 3);
+  /* 3 gönderim = kuyruktan başlayan iş + 1 rapor = üst sohbete düşen iptal sebebi */
+  assert.strictEqual(sent.length, 4);
+  assert.ok(eng._pendingReports.length === 0, 'iptal raporu üst sohbete düştü');
 });
 
-/* ---------- /stop anahtarı ---------- */test('stopAll: koşan turları keser, paralel ajanı aborted işaretler', async () => {
+/* ---------- İPTAL SEBEBİ DİSİPLİNİ ---------- */
+
+test('iptal SEBEBİ zorunlu: interrupt sebebi iş kaydına ve üst sohbete yazar', async () => {
   const { eng } = tmpEngine();
+  const sent = [];
+  eng.send = (sid, payload) => { sent.push({ sid, text: String((payload && payload.text) || '') }); return true; };
+  const r = eng.runBackground('pr', 'koşan iş', 'Sebep İş');
+  const id = r.backgroundId;
+  const c = new AbortController();
+  eng.ctrls.set(id, c);
+
+  eng.interrupt(id, 'kullanıcı panelden iptal etti');
+  assert.ok(c.signal.aborted, 'ctrl kesildi');
+  assert.strictEqual(eng._abortReasons.get(id), 'kullanıcı panelden iptal etti', 'sebep haritada');
+
+  /* _run catch'inin yaptığı iş: haritadan sebebi okuyup _bgFinish'e verir */
+  const why = eng._abortReasons.get(id);
+  eng._abortReasons.delete(id);
+  eng._bgFinish(id, 'aborted', why);
+
+  const j = eng._bgJobs.get(id);
+  assert.strictEqual(j.status, 'aborted');
+  assert.strictEqual(j.error, 'kullanıcı panelden iptal etti', 'sebep iş kaydına yazıldı');
+  const rep = sent.find((x) => x.sid === 'pr' && x.text.includes('[ARKA PLAN İPTAL'));
+  assert.ok(rep, 'üst sohbete İPTAL raporu düştü');
+  assert.ok(/Sebep: kullanıcı panelden/.test(rep.text), 'rapor SEBEPİ içerir');
+});
+
+test('kuyruktaki ajan interrupt ile SEBEPİYLE kesilir', async () => {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'beast-qc-'));
+  const eng = new Engine({}, { sessionsDir: dir, emit: () => {} });
+  eng._bgLimit = 0; // yapıcı min 1 kelepçeler; sıfırla → her iş queued kalır
+  eng.send = () => true;
+  const r = eng.runBackground('pq2', 'kuyruk işi', 'Kuyruk İş');
+  await sleep(80); // admit → bgLimit 0 → queued
+  assert.strictEqual(eng._bgJobs.get(r.backgroundId).status, 'queued');
+
+  assert.strictEqual(eng.interrupt(r.backgroundId, 'sıra iptal edildi'), true);
+  const j = eng._bgJobs.get(r.backgroundId);
+  assert.strictEqual(j.status, 'aborted');
+  assert.strictEqual(j.error, 'sıra iptal edildi', 'kuyruktaki işin iptal sebebi kayda geçti');
+  eng.deleteSession(r.backgroundId);
+});
+
+test('task_cancel reason ZORUNLU: sebep iş kaydına ve note mesajına düşer', async () => {
+  const { eng } = tmpEngine();
+  const r = eng.runBackground('pc', 'iş', 'İptal Edilen');
+  const id = r.backgroundId;
+  const c = new AbortController();
+  eng.ctrls.set(id, c);
+
+  const out = JSON.parse(await eng._execTool('task_cancel', { id, reason: 'yanlış kaynağa baktı' }, {}));
+  assert.ok(out.ok, 'cancel başarılı');
+  assert.ok(/yanlış kaynağa baktı/.test(out.note), 'note ceza sebep içerir');
+  assert.strictEqual(eng._abortReasons.get(id), 'yanlış kaynağa baktı');
+  assert.ok(c.signal.aborted);
+
+  /* reason verilmezse varsayılan sebep yine kayda düşer */
+  const id2 = eng.runBackground('pc', 'iş 2', 'İptal 2').backgroundId;
+  eng.ctrls.set(id2, new AbortController());
+  const out2 = JSON.parse(await eng._execTool('task_cancel', { id: id2 }, {}));
+  assert.ok(out2.ok);
+  assert.ok(eng._abortReasons.get(id2).includes('task_cancel'), 'varsayılan sebep CEO kaynağını söyler');
+});
+
+/* ---------- /stop anahtarı ---------- */
+test('stopAll: koşan turları keser, paralel ajanı aborted işaretler', async () => {  const { eng } = tmpEngine();
   const r = eng.runBackground('pS', 'koşan iş', 'Koşu');
   const id = r.backgroundId;
 

package/tests/obscura.test.js

@@ -0,0 +1,124 @@
+'use strict';
+
+/* Obscura entegrasyonu + sıralı web arama zinciri testleri (ağ çağrısı yok) */
+
+const test = require('node:test');
+const assert = require('node:assert');
+const tools = require('../src/agent/tools');
+const obscura = require('../src/agent/obscura');
+
+test('varsayılan zincir: 4 motor, hepsi açık, obscura AKTİF', () => {
+  const c = tools.getSearchChain();
+  assert.deepEqual(c.map((x) => x.id), ['browser', 'obscura', 'tinyfish', 'python']);
+  for (const r of c) assert.strictEqual(r.on, true, r.id + ' varsayılan açık');
+});
+
+test('setSearchChain: sıra yeniden düzenlenir, eksik motorlar sona eklenir (açık)', () => {
+  const c = tools.setSearchChain([
+    { id: 'obscura', on: true },
+    { id: 'python', on: true },
+    { id: 'browser', on: false },
+  ]);
+  assert.deepEqual(c.map((x) => x.id), ['obscura', 'python', 'browser', 'tinyfish']);
+  assert.strictEqual(c.find((x) => x.id === 'browser').on, false);
+  assert.strictEqual(c.find((x) => x.id === 'tinyfish').on, true, 'listede olmayan motor varsayılan açık');
+  tools.setSearchChain(tools.DEFAULT_SEARCH_CHAIN); /* testler arası temizlik */
+});
+
+test('setSearchChain: hepsi kapalıysa tarayıcı zorunlu açılır (zincir boş kalmasın)', () => {
+  const c = tools.setSearchChain(['obscura', 'tinyfish', 'python', 'browser'].map((id) => ({ id, on: false })));
+  assert.strictEqual(c.find((x) => x.id === 'browser').on, true);
+  tools.setSearchChain(tools.DEFAULT_SEARCH_CHAIN);
+});
+
+test('setSearchChain: bilinmeyen id ve tekrar elenir', () => {
+  const c = tools.setSearchChain([{ id: 'exa', on: true }, { id: 'obscura' }, { id: 'obscura', on: false }, 'python']);
+  assert.deepEqual(c.map((x) => x.id), ['obscura', 'python', 'browser', 'tinyfish']);
+  tools.setSearchChain(tools.DEFAULT_SEARCH_CHAIN);
+});
+
+test('searchChainWeb: sırayı uygular, dolu motorda durur, boş tarayıcı banlanır', async () => {
+  tools.setSearchChain([
+    { id: 'browser', on: true },
+    { id: 'obscura', on: false },
+    { id: 'tinyfish', on: false },
+    { id: 'python', on: false },
+  ]);
+  const calls = [];
+  const r = await tools.searchChainWeb('test sorgu', 5, {
+    browser: async () => {
+      calls.push('browser');
+      return { ok: true, results: [{ title: 'T', url: 'https://x.com', snippet: 's', engine: 'browser' }] };
+    },
+  });
+  assert.ok(r.ok, 'sonuç geldi');
+  assert.strictEqual(calls.length, 1, 'zincir ilk dolu motorda durdu');
+  assert.ok(!tools.browserBanned(), 'başarılı tarayıcı banlanmaz');
+
+  /* tarayıcı boş dönerse 10 dk ban + zincir başarısız (diğer motorlar kapalı) */
+  const r2 = await tools.searchChainWeb('test 2', 5, {
+    browser: async () => {
+      calls.push('browser');
+      return { ok: true, results: [] };
+    },
+  });
+  assert.strictEqual(r2.ok, false);
+  assert.ok(tools.browserBanned(), 'boş sonuç tarayıcıyı banladı');
+  tools.banBrowser(0); /* banı temizle */
+  const r3 = await tools.searchChainWeb('test 3', 5, {
+    browser: async () => {
+      calls.push('browser');
+      return { ok: true, results: [{ title: 'T3', url: 'https://y.com' }] };
+    },
+  });
+  assert.ok(r3.ok && calls.length === 3, 'ban süresi dolunca tarayıcı geri döner');
+  tools.setSearchChain(tools.DEFAULT_SEARCH_CHAIN);
+});
+
+test('searchChainWeb: browser hook yoksa obscura/tinyfish/python sırası izlenir', async () => {
+  tools.setSearchChain([{ id: 'browser', on: true }, { id: 'obscura', on: false }, { id: 'tinyfish', on: false }, { id: 'python', on: false }]);
+  const r = await tools.searchChainWeb('test', 5, {});
+  /* tüm motorlar kapalı/atlanmış → normalize browser'ı zorunlu açtı ama hook yok → başarısız */
+  assert.strictEqual(r.ok, false);
+  tools.setSearchChain(tools.DEFAULT_SEARCH_CHAIN);
+});
+
+test('searchChainWeb: boş sorgu hata döner', async () => {
+  const r = await tools.searchChainWeb('  ', 5, {});
+  assert.strictEqual(r.ok, false);
+  assert.ok(/boş sorgu/.test(r.error));
+});
+
+test('obscura parseDdgLite: lite tablosundan sonuç çıkarır', () => {
+  const html =
+    '<table><tr><td><a rel="nofollow" class="result-link" href="//duckduckgo.com/l/?uddg=https%3A%2F%2Fornek.com%2Fa&amp;rut=1">Örnek A</a></td></tr>' +
+    '<tr><td><a rel="nofollow" class="result-link" href="https://ornek.com/b">Örnek B</a></td></tr></table>';
+  const rows = obscura.parseDdgLite(html, 5);
+  assert.strictEqual(rows.length, 2);
+  assert.strictEqual(rows[0].url, 'https://ornek.com/a');
+  assert.strictEqual(rows[0].title, 'Örnek A');
+  assert.strictEqual(rows[1].url, 'https://ornek.com/b');
+});
+
+test('obscura yolları ve kurulum durumu', () => {
+  assert.ok(/beast[\\/]obscura$/.test(obscura.obscuraDir()));
+  assert.ok(/obscura\.exe$/.test(obscura.obscuraExe()));
+  /* test makinesinde kurulu olabilir — sadece tipleri doğrula */
+  assert.strictEqual(typeof obscura.obscuraInstalled(), 'boolean');
+  assert.strictEqual(typeof obscura.obscuraSearch, 'function');
+  assert.strictEqual(typeof obscura.installObscura, 'function');
+});
+
+test('obscuraSearch: kurulu değilse null döner (zincir atlar)', async () => {
+  const wasInstalled = obscura.obscuraInstalled();
+  if (wasInstalled) return; /* kurulu makinede atla */
+  const r = await obscura.obscuraSearch('sorgu', {});
+  assert.strictEqual(r, null);
+});
+
+test('Exa sistemden tamamen kalktı', () => {
+  for (const k of ['setExaKey', 'exaSearch']) assert.ok(!(k in tools), k + ' export yok');
+  const desc = JSON.stringify(tools.definitions);
+  assert.ok(!/exa\.ai/i.test(desc), 'araç tanımlarında exa yok');
+  assert.ok(!/api\.exa\.ai/i.test(desc));
+});