beast-agent 1.7.0 → 1.8.0

package/bin/beast-agent.js

@@ -87,6 +87,18 @@ if (process.argv[2] === 'update') {
   process.exit(0);
 }
 
+/* SearXNG: yerel arama motoru — kur + arka planda başlat (127.0.0.1:8888)
+   beast searxng        → gerekirse kur, başlat
+   beast searxng status → durum
+   beast searxng stop   → kulla */
+if (process.argv[2] === 'searxng') {
+  require('../src/agent/searxng').cli(process.argv.slice(3)).catch((e) => {
+    console.error('\u2717 ' + String((e && e.message) || e));
+    process.exit(1);
+  });
+  return;
+}
+
 /* detached başlatıcı + kendini onaran electron:
    taze makinalarda npm postinstall sırasında electron binary indirmesi
    sessizce başarısız olmuş olabilir → burada otomatik tamir edilir. */

package/package.json

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

package/src/agent/engine.js

@@ -1,4 +1,4 @@
-'use strict';
+'use strict';
 
 /* Beast engine: sessions, frugal context, streaming tool loop.
    v2: token-bazlı bağlam bütçesi (kullanım kalibrasyonlu), paralel tool
@@ -1519,7 +1519,7 @@ class Engine {
           'Tarayıcı eylemlerinin yanıtındaki recent günlüğü ve navigated bilgisini takip et; eylem yanıtları zaten taze snapshot içerir — refler tutarsız görünürse yeni snapshot al.',
           '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 Obscura stealth tarayıcı + TinyFish + Python çoklu-motor destekli), script gerektiğinde python_run yaz.',
+            '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 (SearXNG + stealth TLS + TinyFish + Python çoklu-motor 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).',
@@ -3685,10 +3685,10 @@ class Engine {
 
   /* web_search zinciri — web_search VE deep_search aynı zinciri kullanır.
      Sıra + aç/kapa Ayarlar → Web Arama'dan değiştirilir (tools.searchChainWeb):
-     varsayılan: 1) dahili tarayıcı (DİREK GOOGLE) 2) Obscura (stealth headless
-     → DuckDuckGo; otomatik kurulur, varsayılan AKTİF) 3) TinyFish (anahtar
-     girildiyse) 4) python çoklu-motor. Tarayıcı CAPTCHA/trafik verirse 10 dk
-     atlanır — sıradaki motor hemen devreye girer. */
+     varsayılan: 1) SearXNG (yerel, ayaktaysa otomatik öne alınır) 2) stealth
+     (curl_cffi Chrome TLS taklidi → DDG html) 3) dahili tarayıcı (DİREK
+     GOOGLE) 4) TinyFish (anahtar girildiyse) 5) python çoklu-motor. Tarayıcı
+     CAPTCHA/trafik verirse 10 dk atlanır — sıradaki motor hemen devreye girer. */
   _webSearchChain(q, n, sessionId, signal) {
     const browserUsable = this.browser && typeof this.browser.search === 'function';
     return tools.searchChainWeb(q, n, {
@@ -4086,7 +4086,7 @@ class Engine {
       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 — sıralı zincir
-           (tarayıcı → Obscura → TinyFish → python; Ayarlar'dan değiştirilir). */
+           (SearXNG → stealth → tarayıcı → TinyFish → python; Ayarlar'dan değiştirilir).. */
         try {
           emitSafe(this, sessionId, { type: 'status', status: 'derin araştırma: çoklu sorgu + gizli sayfa okuma' });
         } catch {}

package/src/agent/llm.js

@@ -249,6 +249,44 @@ async function streamOnce(sel, body, { signal, onDelta, onRetry } = {}, omitReas
         signal.addEventListener('abort', onAbort, { once: true });
       }
       try {
+        /* tek satır SSE olayını işle — hem okuma döngüsü hem SON FLUSH kullanır */
+        const handleLine = (line) => {
+          line = line.trim();
+          if (!line.startsWith('data:')) return;
+          const data = line.slice(5).trim();
+          if (!data || data === '[DONE]') return;
+
+          let json;
+          try {
+            json = JSON.parse(data);
+          } catch {
+            return;
+          }
+
+          if (json.usage) state.usage = json.usage;
+          const ch = json.choices && json.choices[0];
+          if (!ch) return;
+          if (ch.finish_reason) state.finishReason = ch.finish_reason;
+          const d = ch.delta || {};
+          if (d.content) {
+            state.content += d.content;
+            onDelta && onDelta(d.content, state.content);
+          }
+          if (d.reasoning_content) state.reasoning += d.reasoning_content;
+          if (d.reasoning) state.reasoning += d.reasoning;
+          for (const tc of d.tool_calls || []) {
+            const i = typeof tc.index === 'number' ? tc.index : state.toolCalls.length;
+            while (state.toolCalls.length <= i) {
+              state.toolCalls.push({ id: '', type: 'function', function: { name: '', arguments: '' } });
+            }
+            if (tc.id) state.toolCalls[i].id = tc.id;
+            if (tc.function) {
+              if (tc.function.name) state.toolCalls[i].function.name += tc.function.name;
+              if (tc.function.arguments) state.toolCalls[i].function.arguments += tc.function.arguments;
+            }
+          }
+        };
+
         while (true) {
           const { done, value } = await reader.read();
           if (signal && signal.aborted) {
@@ -261,44 +299,18 @@ async function streamOnce(sel, body, { signal, onDelta, onRetry } = {}, omitReas
 
           let idx;
           while ((idx = buf.indexOf('\n')) !== -1) {
-            const line = buf.slice(0, idx).trim();
+            const line = buf.slice(0, idx);
             buf = buf.slice(idx + 1);
-            if (!line.startsWith('data:')) continue;
-            const data = line.slice(5).trim();
-            if (!data || data === '[DONE]') continue;
-
-            let json;
-            try {
-              json = JSON.parse(data);
-            } catch {
-              continue;
-            }
-
-            if (json.usage) state.usage = json.usage;
-            const ch = json.choices && json.choices[0];
-            if (!ch) continue;
-            if (ch.finish_reason) state.finishReason = ch.finish_reason;
-            const d = ch.delta || {};
-            if (d.content) {
-              state.content += d.content;
-              onDelta && onDelta(d.content, state.content);
-            }
-            if (d.reasoning_content) state.reasoning += d.reasoning_content;
-            if (d.reasoning) state.reasoning += d.reasoning;
-            for (const tc of d.tool_calls || []) {
-              const i = typeof tc.index === 'number' ? tc.index : state.toolCalls.length;
-              while (state.toolCalls.length <= i) {
-                state.toolCalls.push({ id: '', type: 'function', function: { name: '', arguments: '' } });
-              }
-              if (tc.id) state.toolCalls[i].id = tc.id;
-              if (tc.function) {
-                if (tc.function.name) state.toolCalls[i].function.name += tc.function.name;
-                if (tc.function.arguments) state.toolCalls[i].function.arguments += tc.function.arguments;
-              }
-            }
+            handleLine(line);
           }
         }
 
+        /* SON FLUSH — KRİTİK: akış son parçası '\n' ile bitmeyebilir.
+           Okuma bitince kalan buf'u Decoder'dan boşaltıp işlemezsek
+           cevabın SON kelimesi/cümlesi kaybolur (SSE sonu öyle gelir). */
+        buf += decoder.decode();
+        if (buf.trim()) handleLine(buf);
+
         return { ...state };
       } finally {
         if (signal && onAbort) {

package/src/agent/scripts/stealthsearch.py

@@ -0,0 +1,30 @@
+#!/usr/bin/env python3
+# Beast stealth search - Obscura yaklasimi: Chrome TLS parmak izi taklidi.
+# curl_cffi (curl-impersonate) ile html.duckduckgo.com'a gercek Chrome kimligiyle girer.
+# stdout: ham DDG HTML - ayristirma JS tarafinda (tools.parseDdgResults) yapilir.
+# Kullanim: stealthsearch.py "<url-encoded-sorgu>"
+import sys
+import urllib.parse
+
+
+def main():
+    if len(sys.argv) < 2:
+        return
+    q = urllib.parse.quote_plus(sys.argv[1])
+    try:
+        from curl_cffi import requests
+    except ImportError:
+        return  # kurulu degil - JS tarafi sessizce atlar
+    try:
+        r = requests.get(
+            "https://html.duckduckgo.com/html/?q=" + q,
+            impersonate="chrome",
+            headers={"Accept-Language": "tr-TR,tr;q=0.9,en;q=0.8"},
+            timeout=15,
+        )
+        sys.stdout.write(r.text or "")
+    except Exception:
+        return
+
+
+main()

package/src/agent/searxng.js

@@ -0,0 +1,325 @@
+'use strict';
+
+/* SearXNG — yerel metasearch entegrasyonu (github.com/searxng/searxng)
+   SearXNG resmi olarak Linux/Docker hedefler; Windows'ta `import pwd`
+   yüzünden patlar. Bu modül Beast'ın GÖMÜLÜ Python'ına gerçek searxng'yi
+   (GitHub master) kurar + pwd shim'i yazar + 127.0.0.1:8888'de arka planda
+   çalıştırır. Arama zinciri 'searxng' motorunu yalnız AYAKTAYSA kullanır.
+
+   CLI:  beast searxng          → gerekirse kur + başlat
+         beast searxng status   → durum
+         beast searxng stop     → kulla */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { spawn, execFile, execSync } = require('child_process');
+
+const REQS_URL = 'https://raw.githubusercontent.com/searxng/searxng/master/requirements.txt';
+const PKG_URL = 'https://github.com/searxng/searxng/archive/refs/heads/master.zip';
+const GETPIP_URL = 'https://bootstrap.pypa.io/get-pip.py';
+const DEFAULT_URL = 'http://127.0.0.1:8888';
+
+/* ---------- yollar ---------- */
+
+function beastAppDir() {
+  if (process.env.BEAST_DATA) return process.env.BEAST_DATA;
+  return process.env.APPDATA
+    ? path.join(process.env.APPDATA, 'beast')
+    : path.join(os.homedir(), 'AppData', 'Roaming', 'beast');
+}
+
+function dir() {
+  const d = path.join(beastAppDir(), 'searxng');
+  try { fs.mkdirSync(d, { recursive: true }); } catch {}
+  return d;
+}
+
+function settingsPath() { return path.join(dir(), 'settings.yml'); }
+function runPyPath() { return path.join(dir(), 'run.py'); }
+function pidPath() { return path.join(dir(), 'server.pid'); }
+function pyExe() { return path.join(beastAppDir(), 'py', 'python.exe'); }
+
+/* ---------- durum yoklama (cache'li) ---------- */
+
+let _probe = { at: 0, up: false, url: '' };
+const PROBE_UP_TTL = 5 * 60 * 1000;
+const PROBE_DOWN_TTL = 2 * 60 * 1000;
+
+function resetProbeCache() { _probe = { at: 0, up: false, url: '' }; }
+
+async function isUp(baseUrl = DEFAULT_URL, { force = false } = {}) {
+  const base = String(baseUrl || DEFAULT_URL).replace(/\/+$/, '');
+  const ttl = _probe.up ? PROBE_UP_TTL : PROBE_DOWN_TTL;
+  if (!force && _probe.url === base && Date.now() - _probe.at < ttl) return _probe.up;
+  let up = false;
+  try {
+    const r = await fetch(`${base}/search?q=beast&format=json`, { signal: AbortSignal.timeout(1800) });
+    if (r.ok) {
+      const j = await r.json();
+      up = j && Array.isArray(j.results);
+    }
+  } catch {}
+  _probe = { at: Date.now(), up, url: base };
+  return up;
+}
+
+/* ---------- arama (zincir motoru) ---------- */
+
+async function search(query, { maxResults = 8, signal, baseUrl } = {}) {
+  const base = String(baseUrl || process.env.BEAST_SEARXNG_URL || DEFAULT_URL).replace(/\/+$/, '');
+  if (!(await isUp(base))) return null; // ayakta değil → zincir sıradaki motora geçer
+  try {
+    const sig =
+      signal && typeof AbortSignal !== 'undefined' && AbortSignal.any
+        ? AbortSignal.any([signal, AbortSignal.timeout(15000)])
+        : AbortSignal.timeout(15000);
+    const r = await fetch(
+      `${base}/search?q=${encodeURIComponent(String(query || ''))}&format=json&safesearch=0`,
+      { signal: sig }
+    );
+    if (!r.ok) return null;
+    const j = await r.json();
+    const results = (j.results || [])
+      .map((x) => ({
+        title: String(x.title || ''),
+        url: String(x.url || ''),
+        snippet: String(x.content || '').replace(/\s+/g, ' ').slice(0, 400),
+        engine: 'searxng',
+      }))
+      .filter((x) => x.url && x.title);
+    if (!results.length) return null;
+    return {
+      ok: true,
+      engine: 'searxng',
+      query,
+      results: results.slice(0, Math.max(1, Math.min(12, Number(maxResults) || 8))),
+    };
+  } catch {
+    return null;
+  }
+}
+
+/* ---------- kurulum ---------- */
+
+function sh(exe, args, timeoutMs = 600000) {
+  return new Promise((resolve, reject) => {
+    execFile(exe, args, { timeout: timeoutMs, windowsHide: true, maxBuffer: 8 * 1024 * 1024 }, (err, stdout, stderr) => {
+      if (err) {
+        const tail = String((stderr || stdout || err.message) || '').slice(-400);
+        return reject(new Error(tail || String(err)));
+      }
+      resolve(String(stdout || ''));
+    });
+  });
+}
+
+async function downloadTo(url, dest) {
+  const r = await fetch(url, { signal: AbortSignal.timeout(120000) });
+  if (!r.ok) throw new Error(`indirme başarısız: HTTP ${r.status}`);
+  fs.writeFileSync(dest, Buffer.from(await r.arrayBuffer()));
+}
+
+function sitePackagesDir(py) {
+  return sh(py, ['-c', 'import sysconfig;print(sysconfig.get_paths()["purelib"])']).then((s) => s.trim());
+}
+
+/* gömülü python'un ._pth dosyasında `import site` açık değilse pip/paketler görünmez */
+function fixEmbeddedPth(py) {
+  try {
+    const dirPy = path.dirname(py);
+    for (const f of fs.readdirSync(dirPy)) {
+      if (/^python\d+\._pth$/.test(f)) {
+        const p = path.join(dirPy, f);
+        const cur = fs.readFileSync(p, 'utf8');
+        if (!/^import site$/m.test(cur)) {
+          fs.writeFileSync(p, cur.replace(/^#\s*import site/m, 'import site'), 'utf8');
+        }
+      }
+    }
+  } catch {}
+}
+
+async function ensurePip(py, onLog) {
+  try {
+    await sh(py, ['-m', 'pip', '--version'], 60000);
+    return;
+  } catch {}
+  onLog('pip kuruluyor…');
+  const gp = path.join(os.tmpdir(), 'beast-get-pip.py');
+  await downloadTo(GETPIP_URL, gp);
+  await sh(py, [gp, '--no-warn-script-location'], 300000);
+  fixEmbeddedPth(py);
+}
+
+/** Tam kurulum — `beast searxng` komutunun yaptığı iş. */
+async function install({ onLog } = {}) {
+  const log = (m) => { try { (onLog || ((s) => console.log('  • ' + s)))(m); } catch {} };
+  const tools = require('./tools');
+  const probe = await tools.ensurePython();
+  const py = probe.exe;
+  log('python: ' + py);
+
+  await ensurePip(py, log);
+  log('setuptools/wheel/tzdata kuruluyor…');
+  await sh(py, ['-m', 'pip', 'install', '--no-warn-script-location', 'setuptools', 'wheel', 'tzdata'], 600000);
+
+  log('searxng bağımlılıkları indiriliyor (~40 MB)…');
+  const reqs = path.join(os.tmpdir(), 'beast-searxng-requirements.txt');
+  await downloadTo(REQS_URL, reqs);
+  await sh(py, ['-m', 'pip', 'install', '--no-warn-script-location', '-r', reqs], 900000);
+
+  log('searxng motoru kuruluyor…');
+  await sh(py, ['-m', 'pip', 'install', '--no-warn-script-location', '--no-build-isolation', PKG_URL], 900000);
+
+  /* pwd shim — searxng/valkeydb.py unix socket sahipliği için pwd import eder */
+  const sp = (await sitePackagesDir(py)) || path.join(path.dirname(py), 'Lib', 'site-packages');
+  const shim = [
+    '"""Windows shim: SearXNG valkeydb.py yalnizca unix-socket sahipligi icin pwd',
+    'kullanir; Windows\'ta valkey devre disi oldugundan donuk yanit yeterlidir."""',
+    'import os',
+    '',
+    'class _Pw:',
+    '    pw_name = "beast"',
+    '    pw_uid = 0',
+    '    pw_gid = 0',
+    '    pw_dir = os.path.expanduser("~")',
+    '    pw_shell = ""',
+    '',
+    'def getpwuid(uid):',
+    '    return _Pw()',
+    '',
+    'def getpwnam(name):',
+    '    return _Pw()',
+    '',
+    'def getgrgid(gid):',
+    '    class _Gr:',
+    '        gr_name = "beast"',
+    '        gr_gid = 0',
+    '    return _Gr()',
+    '',
+    'def getgrnam(name):',
+    '    return getgrgid(0)',
+  ].join('\n');
+  fs.writeFileSync(path.join(sp, 'pwd.py'), shim, 'utf8');
+
+  /* ayarlar + çalıştırıcı */
+  const secret = 'beast-' + Math.random().toString(36).slice(2, 14);
+  fs.writeFileSync(
+    settingsPath(),
+    [
+      'use_default_settings: true',
+      'server:',
+      `  secret_key: "${secret}"`,
+      '  port: 8888',
+      '  bind_address: "127.0.0.1"',
+      '  limiter: false',
+      '  image_proxy: false',
+      'search:',
+      '  formats:',
+      '    - html',
+      '    - json',
+      '',
+    ].join('\n'),
+    'utf8'
+  );
+  fs.writeFileSync(runPyPath(), 'from searx.webapp import run; run()', 'utf8');
+  resetProbeCache();
+  log('kurulum tamam');
+  return { ok: true };
+}
+
+/* ---------- başlat / durdur / durum ---------- */
+
+function readPid() {
+  try {
+    const s = fs.readFileSync(pidPath(), 'utf8').trim();
+    return /^\d+$/.test(s) ? Number(s) : null;
+  } catch {
+    return null;
+  }
+}
+
+async function start({ installIfMissing = true, onLog } = {}) {
+  if (await isUp(DEFAULT_URL, { force: true })) return { ok: true, already: true, url: DEFAULT_URL };
+  if (!fs.existsSync(settingsPath()) || !fs.existsSync(runPyPath())) {
+    if (!installIfMissing) return { ok: false, error: 'kurulu değil — önce: beast searxng' };
+    await install({ onLog });
+  }
+  const tools = require('./tools');
+  const probe = await tools.ensurePython();
+  const child = spawn(probe.exe, [runPyPath()], {
+    detached: true,
+    stdio: 'ignore',
+    windowsHide: true,
+    env: { ...process.env, SEARXNG_SETTINGS_PATH: settingsPath(), PYTHONIOENCODING: 'utf-8' },
+  });
+  try { fs.writeFileSync(pidPath(), String(child.pid)); } catch {}
+  child.unref();
+  /* ayağa kalkmasını bekle (ilk açılış motor listesini derler — birkaç sn) */
+  for (let i = 0; i < 20; i++) {
+    await new Promise((r) => setTimeout(r, 1000));
+    if (await isUp(DEFAULT_URL, { force: true })) return { ok: true, url: DEFAULT_URL, pid: child.pid };
+  }
+  return { ok: false, error: 'searxng başlatılamadı (20 sn içinde yanıt yok)' };
+}
+
+function stop() {
+  const pid = readPid();
+  if (!pid) return { ok: true, note: 'çalışmıyor' };
+  try {
+    execSync(`taskkill /PID ${pid} /T /F`, { stdio: 'ignore' });
+  } catch {}
+  try { fs.unlinkSync(pidPath()); } catch {}
+  resetProbeCache();
+  return { ok: true, stopped: pid };
+}
+
+async function status() {
+  return {
+    up: await isUp(DEFAULT_URL, { force: true }),
+    url: DEFAULT_URL,
+    pid: readPid(),
+    installed: fs.existsSync(settingsPath()) && fs.existsSync(runPyPath()),
+  };
+}
+
+/* ---------- CLI (bin/beast-agent.js → beast searxng) ---------- */
+
+async function cli(argv) {
+  const sub = String(argv[0] || 'start').toLowerCase();
+  console.log('\u27F3 SearXNG (yerel arama motoru)');
+  if (sub === 'stop') {
+    const r = stop();
+    console.log(r.ok ? '\u2713 durduruldu' : '\u2717 durdurulamadı');
+    process.exit(r.ok ? 0 : 1);
+  }
+  if (sub === 'status') {
+    const s = await status();
+    console.log(`  kurulu : ${s.installed ? 'evet' : 'hayır'}`);
+    console.log(`  çalışıyor: ${s.up ? 'evet (' + s.url + ')' : 'hayır'}`);
+    process.exit(0);
+  }
+  /* start */
+  const r = await start({ installIfMissing: true, onLog: (m) => console.log('  \u2022 ' + m) });
+  if (r.ok) {
+    console.log(r.already ? '\u2713 SearXNG zaten çalışıyor — ' + r.url : '\u2713 SearXNG başlatıldı — ' + r.url);
+    console.log('\u2139 arama zincirinde kullanılmaya hazır (Ayarlar → Web Arama sırası)');
+    process.exit(0);
+  }
+  console.error('\u2717 ' + (r.error || 'başlatılamadı'));
+  process.exit(1);
+}
+
+module.exports = {
+  search,
+  isUp,
+  resetProbeCache,
+  install,
+  start,
+  stop,
+  status,
+  cli,
+  settingsPath,
+  DEFAULT_URL,
+};

package/src/agent/seeds/brainstorming/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: brainstorming
+description: Yaratıcı işe KOD YAZMADAN ÖNCE kullan — yeni özellik, yeni proje, bileşen, davranış değişikliği istendiğinde; niyeti, gereksinimleri ve tasarımı kullanıcıyla netleştirmeden implementasyona geçmek yasaktır.
+---
+
+# Brainstorming: Fikirden Tasarıma
+
+Fikirleri doğal diyalogla tam oluşmuş tasarımlara dönüştür.
+
+Akış: bağlamı anla → fikri netleştir → tasarımı sun → kullanıcı onayı.
+
+<ZOR KAPI>
+Kullanıcıya ne yapacağını söyleyip onayı almadan HİÇBİR implementasyon
+eylemi yok: kod yazma, proje scaffold'ı, dosya üretme. Bu kapı HER görev
+için geçerlidir; törenin boyutu göreve göre ölçeklenir ama ONAY KAPISI
+ölçeklenmez.
+</ZOR KAPI>
+
+## Üç Yol
+
+İlk sorudan önce isteği SINIFLANDIR ve sınıfı sesli söyle — "bu sınırlı
+kapsamlı görünüyor, spec dosyası yazmak yerine kısa tasarımı burada sunacağım"
+— kullanıcı override edebilsin:
+
+- **Spike** — fizibilite sorusu ("yapılabilir mi", "hızlı-çirkin olsun").
+  Çıktısı tuttuğun kod değil, bir CEVAPTIR. Soru ve deneme planını 2-3
+  cümleyle sun, onay al, en ucuz yolla araştır. Tasarım dosyası yok.
+  Bulgu → öneri olarak raporla; bir şey inşa ettiysen "atılabilir" etiketiyle.
+- **Sınırlı (Bounded)** — mevcut koda iyi tanımlı değişiklik: yeni flag,
+  küçük endpoint, tek dosyalık fix. "Sınırlı" için DEĞİŞTİRECEĞİN AKIŞIN
+  Bu projede zaten var olması şart. Önemli netleştirme sorularını sor,
+  KISA tasarımı SOHBETTE sun (birkaç cümle - paragraf) ve DUR. Kullanıcı
+  "evet" demeden implementasyon yok. Spec dosyası yok, plan dosyası yok.
+- **Mimari** — yeni projeler, yeni alt sistemler, bileşen ilişkilerini
+  değiştiren işler. Tam süreç: sorular → 2-3 yaklaşım → bölümlü tasarım →
+  yazılı spec → writing-plans skill'i.
+
+İki yol arasında tereddüt varsa AĞIRINI seç. Ortasında gizli karmaşıklık
+çıkarsa yol YÜKSELTİLİR (dur, söyle, büyüt); asla aşağı inmez.
+
+## Anti-Desen: "Onaya Gerek Yok Kadar Basit"
+
+Her yol onayla biter. Todo listesi, tek fonksiyon, config değişikliği —
+tasarım sohbette iki cümle olabilir ama SUN ve ONAY AL. "Basit" işler,
+incelenmemiş varsayımların en çok iş boşa çıkardığı yerdir. Basitlikle
+ölçeklenen şey artefaktır; onay asla değil.
+
+## Kırmızı Bayraklar
+
+| Düşünce | Gerçek |
+|---|---|
+| "Bu, tasarım gerektirmeyecek kadar basit" | Basitlik kısa tasarım demektir, tasarım yok demek değil. |
+| "Sınırlı der spec'i atlarım" | Etiket arayışı şüphenin ta kendisi — ağır yolu seç. |
+| "Tasarım bariz, onu okurken başlarım" | Kapı onaydır, tasarımın uzunluğu değil. Sun ve evet bekle. |
+| "Bu tür app'leri biliyorum, sınırlıdır" | Sınırlı olma projeyi ölçer, bilgini değil. Akış yoksa mimaridir. |
+| "Spike çalıştı, kodu tutayım" | Spike'ın çıktısı cevaptır. Kodu tutmak YENİ istektir — sınıflandır. |
+| "Büyüdü ama az kaldı, yeniden sınıflandırmaya gerek yok" | Gizli karmaşıklık yolu ortada yükseltir. Dur ve söyle. |
+
+## Kontrol Listesi
+
+**Spike:** bağlamı gör → soru+plan sun (2-3 cümle) → onay → en ucuz yolla araştır → öneri raporla.
+
+**Sınırlı:** bağlamı gör (dosyalar, dokümanlar, son commit'ler) → netleştirme
+soruları TEK TEK → kısa tasarımı sohbette sun (yaklaşım, dokunulan dosyalar,
+test stratejisi) → açık "evet" bekle (sunup hemen başlamak = kapıyı atlamak) →
+normal iş akışıyla uygula (TDD geçerli).
+
+**Mimari:**
+1. Bağlamı gör: mevcut yapıyı list_dir/grep/read_file ile incele, deseni takip et
+2. Netleştirme soruları — TEK SORU PER MESAJ; amaç/kısıt/başarı kriterini anla;
+   çoklu seçmeli soru tercih et
+3. Kapsam çok buysa parçala: bağımsız alt-projelere böl, sırayı belirle,
+   ilk alt-projeyle normal akışa gir
+4. 2-3 yaklaşım öner — artı/eksileriyle; önerini BAŞA koy ve nedenini söyle;
+   her yaklaşımda YAGNI: gereksiz özelliği çıkar
+5. Tasarımı bölümler halinde sun — mimari, bileşenler, veri akışı, hata
+   yönetimi, test stratejisi; her bölümün ardından "şimdiye kadar doğru mu?" de
+6. Onaylı tasarımı yaz: `<workspace>/docs/plans/specs/YYYY-MM-DD-<konu>-design.md`
+7. Spec öz-denetim: "TBD/TODO" var mı, iç tutarlılık, kapsam tek plana sığıyor mu,
+   iki şekilde yorumlanabilir gereksinim var mı → düzelt
+8. Kullanıcıya spec dosyasını göster, incelemesini iste
+9. Onay gelince writing-plans skill'iyle implementasyon planına geç — başka hiçbir
+   implementasyon adımı bu kapıdan önce gelmez
+
+## Mevcut Kodda Çalışırken
+
+- Değişiklik önermeden önce mevcut yapıyı incele; var olan deseni takip et
+- İşini etkileyen sorunlu noktalar varsa (şişmiş dosya, bulanık sınır) hedefli
+  iyileştirmeyi tasarıma dahil et
+- Alakasız refactoring önerme — mevcut hedefe hizmet eden kal