beast-agent 2.19.1 → 2.21.0

package/package.json

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

package/src/agent/customtools.js

@@ -0,0 +1,242 @@
+'use strict';
+
+/* KİŞİSEL TOOLLAR: %APPDATA%\beast\tools\<slug>\tool.json + run.js
+   Kullanıcı (ya da ajan) Node ile koşan kendi araçlarını yazar; TÜM oturumlar
+   — BEAST FINANCE dahil — bunları model'e açılan gerçek araç olarak çağırır
+   (tool__<slug>). Sözleşme:
+     - stdin  : JSON argümanlar
+     - stdout : JSON sonuç (son satır JSON'a çevrilmeye çalışılır)
+     - çalışma klasörü: tool'un kendi klasörü (%APPDATA%\beast\tools\<slug>)
+   Sonuç model'e { ok, ... } olarak döner; çocuk proses izoledir (uygulama
+   çökmez), 90 sn zaman aşımı vardır. */
+
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+const { beastRoot } = require('./memory');
+
+let notify = () => {};
+function setNotify(fn) {
+  notify = typeof fn === 'function' ? fn : () => {};
+}
+
+function dir() {
+  return path.join(beastRoot(), 'tools');
+}
+
+function slugify(name) {
+  return String(name || '')
+    .toLowerCase()
+    .replace(/[^a-z0-9_-]+/g, '_')
+    .replace(/^_+|_+$/g, '')
+    .slice(0, 24);
+}
+
+let cache = null;
+let dirty = true;
+
+function invalidate() {
+  dirty = true;
+  cache = null;
+}
+
+function readTool(d) {
+  try {
+    const json = JSON.parse(fs.readFileSync(path.join(d, 'tool.json'), 'utf8'));
+    if (!json || typeof json !== 'object' || !json.name) return null;
+    const runJs = path.join(d, 'run.js');
+    if (!fs.existsSync(runJs)) return null;
+    return {
+      id: path.basename(d),
+      name: String(json.name).slice(0, 40),
+      description: String(json.description || '').slice(0, 300),
+      parameters:
+        json.parameters && typeof json.parameters === 'object'
+          ? json.parameters
+          : { type: 'object', properties: {} },
+      script: runJs,
+      code: fs.readFileSync(runJs, 'utf8').slice(0, 20000),
+      updatedAt: json.updatedAt || null,
+    };
+  } catch {
+    return null;
+  }
+}
+
+function scan() {
+  const out = [];
+  try {
+    for (const e of fs.readdirSync(dir(), { withFileTypes: true })) {
+      if (!e.isDirectory()) continue;
+      const t = readTool(path.join(dir(), e.name));
+      if (t) out.push(t);
+    }
+  } catch {}
+  return out;
+}
+
+function list() {
+  return scan();
+}
+
+/* engine _chatTurn'e OpenAI function formatında şemalar */
+function definitions() {
+  if (dirty || !cache) {
+    cache = scan();
+    dirty = false;
+  }
+  return cache.map((t) => ({
+    type: 'function',
+    function: {
+      name: 'tool__' + t.id,
+      description:
+        (t.description || 'kişisel tool') + ` (kişisel tool — args stdin JSON, sonuç stdout JSON)`,
+      parameters: t.parameters,
+    },
+  }));
+}
+
+function names() {
+  if (dirty || !cache) {
+    cache = scan();
+    dirty = false;
+  }
+  return cache.map((t) => 'tool__' + t.id);
+}
+
+const TOOL_TIMEOUT_MS = 90 * 1000;
+
+/* Tool'u çocuk node prosesinde koşturur — uygulama asla çökmez */
+function call(name, args) {
+  return new Promise((resolve) => {
+    const id = String(name || '').replace(/^tool__/, '');
+    if (!id) return resolve({ ok: false, error: 'tool adı gerekli' });
+    const t = scan().find((x) => x.id === id);
+    if (!t) return resolve({ ok: false, error: 'tool bulunamadı: ' + id });
+    const t0 = Date.now();
+    let child = null;
+    let out = '';
+    let err = '';
+    let done = false;
+    const finish = (r) => {
+      if (done) return;
+      done = true;
+      clearTimeout(killer);
+      try {
+        notify({
+          at: new Date().toISOString(),
+          tool: t.name,
+          toolId: id,
+          ok: !!r.ok,
+          ms: Date.now() - t0,
+          error: r && r.error ? String(r.error).slice(0, 200) : null,
+        });
+      } catch {}
+      resolve(r);
+    };
+    let killer = setTimeout(() => {
+      try { child && child.kill(); } catch {}
+      finish({ ok: false, error: 'tool zaman aşımı (' + Math.round(TOOL_TIMEOUT_MS / 1000) + ' sn)' });
+    }, TOOL_TIMEOUT_MS);
+    try {
+      child = spawn(process.execPath, [t.script], { cwd: t.path, stdio: ['pipe', 'pipe', 'pipe'] });
+    } catch (e) {
+      return finish({ ok: false, error: String((e && e.message) || e) });
+    }
+    child.stdout.on('data', (d) => { out += d; });
+    child.stderr.on('data', (d) => { err += d; });
+    child.on('error', (e) => finish({ ok: false, error: String((e && e.message) || e) }));
+    child.on('close', (code) => {
+      const raw = String(out || '').trim();
+      let data = null;
+      try { data = raw ? JSON.parse(raw) : null; } catch {}
+      if (data === null || typeof data !== 'object' || Array.isArray(data) || typeof data.ok !== 'boolean') {
+        data = { ok: code === 0, result: data === null ? raw.slice(0, 4000) : data };
+      }
+      if (code !== 0) {
+        if (data.ok !== false) data.ok = false;
+        if (!data.error) data.error = String(err || '').slice(0, 400) || 'çıkış kodu ' + code;
+      }
+      finish(data);
+    });
+    try {
+      child.stdin.write(JSON.stringify(args || {}));
+      child.stdin.end();
+    } catch {}
+  });
+}
+
+function save({ id, name, description, parameters, code }) {
+  const slug = id && /^[a-z0-9_-]{2,24}$/.test(String(id)) ? String(id) : slugify(name);
+  if (!slug) return { ok: false, error: 'tool adı gerekli (a-z 0-9 _ -)' };
+  const d = path.join(dir(), slug);
+  try {
+    fs.mkdirSync(d, { recursive: true });
+    fs.writeFileSync(
+      path.join(d, 'tool.json'),
+      JSON.stringify(
+        {
+          name: String(name || slug).slice(0, 40),
+          description: String(description || '').slice(0, 300),
+          parameters:
+            parameters && typeof parameters === 'object' && !Array.isArray(parameters)
+              ? parameters
+              : { type: 'object', properties: {} },
+          updatedAt: new Date().toISOString(),
+        },
+        null,
+        2
+      )
+    );
+    const js = String(code || '').trim();
+    if (!js) return { ok: false, error: 'run.js kodu boş olamaz' };
+    fs.writeFileSync(path.join(d, 'run.js'), js.slice(0, 20000));
+    invalidate();
+    return { ok: true, id: slug };
+  } catch (e) {
+    return { ok: false, error: String((e && e.message) || e) };
+  }
+}
+
+function remove(id) {
+  const slug = String(id || '');
+  if (!/^[a-z0-9_-]{2,24}$/.test(slug)) return { ok: false, error: 'geçersiz tool kimliği' };
+  try {
+    fs.rmSync(path.join(dir(), slug), { recursive: true, force: true });
+    invalidate();
+    return { ok: true };
+  } catch (e) {
+    return { ok: false, error: String((e && e.message) || e) };
+  }
+}
+
+/* Örnek tool: klasör boşsa biçimi göstermek için bir adet kur */
+function seedIfEmpty() {
+  try {
+    if (scan().length) return;
+    save({
+      name: 'ornek_echo',
+      description:
+        'Örnek kişisel tool — gelen argümanları geri döndürür. Bu klasörü kopyalayarak kendi toollarını yaz; agent finance dahil tüm oturumlarda tool__<ad> olarak çağırır.',
+      parameters: {
+        type: 'object',
+        properties: {
+          mesaj: { type: 'string', description: 'geri döndürülecek deneme mesajı' },
+        },
+        required: ['mesaj'],
+      },
+      code:
+        "'use strict';\n" +
+        "// KİŞİSEL TOOL — stdin: JSON args · stdout: JSON sonuç\n" +
+        "// Bu klasörü kopyalayıp kendi araçlarını yaz (örn. MT5 emir köprüsü, özel API çağrısı…)\n" +
+        "const fs = require('fs');\n" +
+        "let raw = '';\n" +
+        "try { raw = fs.readFileSync(0, 'utf8'); } catch {}\n" +
+        "let args = {};\n" +
+        "try { args = JSON.parse(raw || '{}'); } catch {}\n" +
+        "console.log(JSON.stringify({ ok: true, echo: args, not: 'run.js ve tool.json düzenlenebilir' }));\n",
+    });
+  } catch {}
+}
+
+module.exports = { setNotify, list, scan, definitions, names, call, save, remove, seedIfEmpty, invalidate, dir, slugify };

package/src/agent/engine.js

@@ -13,6 +13,7 @@ const tools = require('./tools');
 let financetools = null;
 try { financetools = require('./financetools'); } catch {}
 const FINANCE_TOOL_SET = new Set(financetools ? financetools.NAMES : []);
+const customtools = require('./customtools');
 const research = require('./research');
 const agentdefs = require('./agentdefs');
 const memory = require('./memory');
@@ -1232,7 +1233,14 @@ class Engine {
         let r;
         try { r = JSON.parse(l); } catch { continue; }
         if (r.t === 'meta') out.push(JSON.stringify({ t: 'meta', id: s.id, code: s.code, createdAt: s.createdAt }));
-        else if (r.t === 'meta2' || r.t === 'bot' || r.t === 'todo') out.push(l);
+        /* KALICİ ETİKETLER compact'ta ASLA düşmez — özellikle 'fin'/'finoff':
+           silinirse finance oturumu etiketini KAYBEDER ve mt5_* araçları
+           "unknown tool" olur (bayat compact kaybı bu yüzden) */
+        else if (
+          r.t === 'meta2' || r.t === 'bot' || r.t === 'todo' ||
+          r.t === 'fin' || r.t === 'finoff' ||
+          r.t === 'agent' || r.t === 'bcws' || r.t === 'botdm'
+        ) out.push(l);
       }
       if (lastNotesLine) out.push(lastNotesLine);
       /* korunan pencere: son N mesaj */
@@ -1419,7 +1427,12 @@ class Engine {
       const kept = lines.filter((l) => {
         try {
           const r = JSON.parse(l);
-          return r.t === 'meta' || r.t === 'meta2' || r.t === 'bot' || r.t === 'todo';
+          /* kalıcı etiketler korunur (fin/finoff dahil — finance bayrağı kaybolmasın) */
+          return (
+            r.t === 'meta' || r.t === 'meta2' || r.t === 'bot' || r.t === 'todo' ||
+            r.t === 'fin' || r.t === 'finoff' ||
+            r.t === 'agent' || r.t === 'bcws' || r.t === 'botdm'
+          );
         } catch { return false; }
       });
       const tmp = file + '.tmp';
@@ -3453,6 +3466,9 @@ class Engine {
       toolsList = await mcp.mergeTools(toolsList);
       /* Beast Apps: kurulu app'lerin araçları (app__<id>__<tool>) modele açılır */
       toolsList = apps.mergeTools(toolsList);
+      /* KİŞİSEL TOOLLAR: %APPDATA%\beast\tools\<ad>\ — kullanıcı yazmışsa
+         TÜM oturumlara (BEAST FINANCE dahil) tool__<ad> olarak açılır */
+      toolsList = [...toolsList, ...customtools.definitions()];
       /* Beast Finance: skill aracı da açık — kataloğun SKILL.md gövdesi
          modele açılır (skill handler'ı zaten tüm oturumlar için çalışır,
          definition yalnız BC'de vardı; finance chat copilot + trader ikisi de)
@@ -3464,8 +3480,13 @@ class Engine {
         if (skillDef) toolsList = [...toolsList, skillDef];
       }
       /* AJAN DM: koşan ajan oturumlarına (arka plan işleri + finance
-         ajanları) ajanlar-arası mesajlaşma aracı verilir */
-      if (session && (session.bgJob || (session.finance && session.bgTitle))) {
+         ajanları) VE ana sohbete verilir — chat Beast'i de ajana DM atabilir;
+         müşteri bot oturumları (botId ≠ beast) ve botlar arası DM hariç */
+      if (
+        session &&
+        !session.isBotDm &&
+        (session.bgJob || session.finance || !session.botId || session.botId === 'beast')
+      ) {
         toolsList = [...toolsList, AGENT_DM_DEF];
       }
       /* panel_run yalnız SANDBOX oturumlarında görünsün — diğer panellerde
@@ -3890,6 +3911,8 @@ class Engine {
         // Paralel yürütme — bağımsız çağrılar beklemesin
         session.toolsSinceReflect = (session.toolsSinceReflect || 0) + res.toolCalls.length;
         if (!this._knownToolNames) this._knownToolNames = new Set([...TOOLS.map((t) => t.function.name), ...opencode.toolmap.names()]);
+        /* kişisel tool sonradan yazılabilir — isim havuzunu canlı tazele */
+        for (const n of customtools.names()) this._knownToolNames.add(n);
         await Promise.all(
           res.toolCalls.map(async (tc) => {
             let name = tc.function && tc.function.name;
@@ -4765,6 +4788,10 @@ const skills = require('./skills');
       if (name === 'agent_dm') {
         return JSON.stringify(this._agentDmSend(sessionId, args));
       }
+      /* KİŞİSEL TOOL: %APPDATA%\beast\tools\ — çocuk node prosesinde izole koşar */
+      if (String(name).startsWith('tool__')) {
+        return JSON.stringify(await customtools.call(name, args));
+      }
       if (isBc) {
         /* opencode permission akışı (tool/external-directory.ts + her aracın
            ctx.ask'ı): önce workspace DIŞI erişim izni, sonra araç izni.
@@ -4796,7 +4823,9 @@ const skills = require('./skills');
            "always" onaylı araçlar doğrudan geçer. (BC dışı oturumlar — opencode
            izin sistemi yalnız Beast Code oturumlarında koşar) */
         if (
-          (Engine.RISKY_TOOLS.has(name) || String(name).startsWith('mcp__')) &&
+          (Engine.RISKY_TOOLS.has(name) ||
+            String(name).startsWith('mcp__') ||
+            String(name).startsWith('tool__')) && /* kişisel tool = kullanıcı kodu koşturur */
           !this.alwaysAllowTools.has(name) &&
           this.approvals && typeof this.approvals.request === 'function'
         ) {
@@ -5288,23 +5317,25 @@ function emitSafe(engine, sessionId, ev) {
 
 /* AJAN DM aracı: paralel/finance ajanlarının birbirine kısa mesaj atması.
    Salt metin — hedef ajanın oturumuna [AJAN DM] bloğu olarak düşer; AJAN DM
-   panelinde iki yönlü görünür. */
+   panelinde iki yönlü görünür. topic verirsen aynı konudaki mesajlar aynı
+   oturumda toplanır (cevap zinciri tek thread'de devam eder). */
 const AGENT_DM_DEF = {
   type: 'function',
   function: {
     name: 'agent_dm',
     description:
-      'Send a short DM to another RUNNING agent (parallel agents / finance agents) to coordinate: share findings, ask status, warn about risk, hand off work. `to` = target session id OR a keyword from the agent title (e.g. "GOLD", "Trader"). The message is delivered to the other agent and shown in the Agent DM panel.',
+      'Send a short DM to another running agent (parallel agents / finance agents) to coordinate: share findings, ask status, warn about risk, hand off work. `to` = target session id OR a keyword from the agent title (e.g. "GOLD", "Trader"). `topic` = short subject label — replies to the same topic stay in the SAME conversation thread, so ALWAYS reuse the topic you were DMed with when replying.',
     parameters: {
       type: 'object',
       properties: {
         to: { type: 'string', description: 'Target agent session id or a title keyword' },
+        topic: { type: 'string', description: 'Short subject label for the conversation thread, e.g. "GOLD pozisyon riski"' },
         message: { type: 'string', description: 'Short message (1-3 sentences)' },
       },
       required: ['to', 'message'],
     },
   },
-};
+};
 
 const TOOLS = [
   ...tools.definitions,
@@ -6121,12 +6152,15 @@ Engine.prototype._agentDmSend = function (fromSid, args) {
     if (String(target) === String(fromSid)) return { ok: false, error: 'kendine DM atılamaz' };
     const fromJob = jobs.get(String(fromSid));
     const toJob = jobs.get(target);
+    /* konu etiketi: aynı konudaki DM'ler panelde AYNI oturumda toplanır */
+    const topic = String((args && args.topic) || '').replace(/\s+/g, ' ').trim().slice(0, 60) || '(genel)';
     const dm = {
       at: new Date().toISOString(),
       from: String(fromSid),
       fromTitle: (fromJob && fromJob.title) || 'Ajan',
       to: String(target),
       toTitle: (toJob && toJob.title) || 'Ajan',
+      topic,
       text,
     };
     this._agentDms = this._agentDms || [];
@@ -6136,15 +6170,16 @@ Engine.prototype._agentDmSend = function (fromSid, args) {
       fs.writeFileSync(this._agentDmsFile, JSON.stringify({ dms: this._agentDms }, null, 2));
     } catch {}
     emitSafe(this, target, { type: 'agent-dm', ...dm });
-    /* teslim: hedef meşgulse pending kuyruğunda bekler, done olunca düşer */
+    /* teslim: hedef meşgulse pending kuyruğunda bekler, done olunca düşer.
+       Cevap zinciri AYNI thread'den sürsün diye topic geri bildirilir. */
     (this._pendingReports = this._pendingReports || []).push({
       parentId: target,
       text:
-        `[AJAN DM — ${dm.fromTitle}]\n${text}\n` +
-        `(Cevabını agent_dm aracıyla ver — to: "${dm.fromTitle}")`,
+        `[AJAN DM — ${dm.fromTitle} · konu: "${topic}"]\n${text}\n` +
+        `(Cevabını agent_dm aracıyla ver — to: "${dm.fromTitle}", topic: "${topic}")`,
     });
     this.flushPendingReports(target);
-    return { ok: true, to: target, toTitle: dm.toTitle };
+    return { ok: true, to: target, toTitle: dm.toTitle, topic };
   } catch (e) {
     return { ok: false, error: String((e && e.message) || e) };
   }

package/src/agent/skills.js

@@ -129,7 +129,8 @@ Get-Content "$env:APPDATA\\beast\\sessions\\bg-jobs.json" | ConvertFrom-Json | %
 | \`agent/agentdefs.js\` | Özel ajan tanımları: %APPDATA%\beast\agents\\*.md (frontmatter: model/tools/steps/mode + prompt gövdesi); /agent ile bağlanır, run_background(agent:) ile paralel ajana verilir |
 | \`agent/searxng.js\` | SearXNG entegrasyonu: gömülü Python'a kurulum + 127.0.0.1:8888 başlatıcı + JSON arama motoru |
 | \`agent/bots.js\` | Bot CRUD, 5 haneli bot kodu, izolasyon; ad-ilk-harf doğrulaması |
-| \`agent/skills.js\` | Builtin tohumlar (help, email, python-web-search, pdf, gold-trading + superpowers metodoloji paketi: brainstorming/writing-plans/executing-plans/TDD/paralel-ajan/alt-ajan-geliştirme/sistematik-debugging/doğrulama/skill-yazma) + SKILL.md taraması + taslaklar |
+| \`agent/skills.js\` | Builtin tohumlar (help, email, python-web-search, pdf, gold-trading, tool-yazma + superpowers metodoloji paketi: brainstorming/writing-plans/executing-plans/TDD/paralel-ajan/alt-ajan-geliştirme/sistematik-debugging/doğrulama/skill-yazma) + SKILL.md taraması + taslaklar |
+| \`agent/customtools.js\` | Kişisel toollar: %APPDATA%\\beast\\tools\\<ad>\\tool.json + run.js (stdin JSON → stdout JSON) — tool__<ad> olarak TÜM oturumlara açılır; sol panel TOOLLAR kutusunda yazılır/test edilir. Yeni tool yazarken \`tool-yazma\` skill'ini oku. |
 | \`agent/memory.js\`, \`agent/kb.js\` | Kalıcı hafıza + bilgi bankası |
 | \`cron.js\` (src kökü), \`agent/watchers.js\`, \`agent/bus.js\` | Cron, izleyici, olay merkezi — /stop bunlara DOKUNMAZ |
 | \`agent/usage.js\` | Token/maliyet sayaçları |
@@ -456,6 +457,87 @@ const { createWorker } = require('tesseract.js');
 | read_file boş metin döndü | taranmış PDF → 4. adım (görselleştir) + 5. adım (OCR) |
 | tesseract dil verisi hatası | ilk indirme internet ister; tekrar dene |`,
   },
+  {
+    folder: 'tool-yazma',
+    force: true,
+    body: `---
+name: tool-yazma
+description: Kişisel TOOL yazma/düzenleme rehberi — %APPDATA%\\beast\\tools\\<ad>\\ altına tool.json + run.js yazılacak veya mevcut bir tool editlenecekse ÖNCE bu skill'i oku. Tool'un sözleşmesi: stdin JSON argüman → stdout JSON sonuç; ajan tool__<ad> olarak çağırır (Beast Finance dahil tüm oturumlarda çalışır).
+version: 1.0.0
+---
+
+# Kişisel TOOL Yazma
+
+## TOOL NEDİR / NE ZAMAN YAZILIR
+
+Kişisel tool = modelin alet çantasına GİREN gerçek bir araçtır: %APPDATA%\\beast\\tools\\<slug>\\ klasöründe **tool.json** (tanım) + **run.js** (kod) bulunur. Tüm oturumlarda — Beast Finance chat/trader/işçiler dahil — \`tool__<slug>\` adıyla çağrılır.
+
+Yaz ZAMAN: mevcut araçlar işi görmüyorsa (örn. broker sembol adlandırması mt5_trade'i düşürüyorsa), özel bir API'ye bağlanman, tekrarlı bir hesap/işlem rutini gerekiyorsa. Basit işler için YAZMA — önce yerleşik araçları (mt5_*, web_search, python_run, run_command) dene.
+
+## SÖZLEŞME (birebir uygula)
+
+- **stdin**: JSON argümanlar (tek satırda, güvenli parse)
+- **stdout**: SADECE JSON sonuç — son satır JSON'a çevrilmeye çalışılır; günlük/metin yazarsan JSON bozulur, \`console.error\` kullan
+- **çalışma klasörü**: tool'un kendi klasörü (yanına dosya yazabilirsin)
+- **zaman aşımı**: 90 sn — uzun işleri kendin parçalama, \`run_background\`'a devret
+- **sonuç biçimi**: \`{ "ok": true, ... }\` ya da \`{ "ok": false, "error": "sebep" }\` — ok alanı ZORUNLU
+
+## YENİ TOOL OLUŞTURMA (2 dosya, write_file ile)
+
+\`%APPDATA%\\beast\\tools\\<slug>\\tool.json\`:
+\`\`\`json
+{
+  "name": "gold_emir",
+  "description": "GOLD için özel emir açar — side (buy/sell), lot, sl, tp alır; sonucu ticket ile döndürür.",
+  "parameters": {
+    "type": "object",
+    "properties": {
+      "side": { "type": "string", "description": "buy | sell" },
+      "lot": { "type": "number", "description": "0.01-1.0" },
+      "sl": { "type": "number" },
+      "tp": { "type": "number" }
+    },
+    "required": ["side", "lot"]
+  },
+  "updatedAt": "2026-09-09T00:00:00.000Z"
+}
+\`\`\`
+
+\`%APPDATA%\\beast\\tools\\<slug>\\run.js\`:
+\`\`\`javascript
+'use strict';
+// stdin: JSON args · stdout: JSON sonuç (SADECE JSON yaz!)
+const fs = require('fs');
+let args = {};
+try { args = JSON.parse(fs.readFileSync(0, 'utf8') || '{}'); } catch {}
+(function main() {
+  const { side, lot, sl, tp } = args;
+  if (!side || !lot) {
+    console.log(JSON.stringify({ ok: false, error: 'side ve lot zorunlu' }));
+    return;
+  }
+  // --- kendi işin burada: HTTP çağrısı, MT5 köprüsü, dosya, hesap... ---
+  // Örn: https modülüyle özel endpoint'e istek at, sonucu ok alanıyla sar.
+  console.log(JSON.stringify({ ok: true, side, lot, sl: sl || 0, tp: tp || 0, ticket: 0 }));
+})();
+\`\`\`
+
+Slug kuralları: a-z, 0-9, alt çizgi, tire — 2-24 karakter (örn: gold_emir, haber_ozet). Hazır taslak: %APPDATA%\\beast\\tools\\ornek_echo klasörünü referans al; yeni tool'u o biçimle yaz.
+
+## DÜZENLEME / DOĞRULAMA
+
+1. Mevcut toolu değiştirme: \`edit_file\` ile tool.json / run.js düzenle — ASLA tüm klasörü silip baştan yazma.
+2. Kayıttan sonra tool ANINDA aktifleşir (yeniden başlatma gerekmez) — bir sonraki turda \`tool__<slug>\` çağrılabilir.
+3. Doğrula: \`run_command\` ile \`echo \\"{\\\\\\"mesaj\\\\\\":\\\\\\"test\\\\\\"}\\" | node \\"%APPDATA%\\\\beast\\\\tools\\\\<slug>\\\\run.js\\"\` — çıktı JSON olmalı ve \`ok\` alanı içermeli.
+4. Hata çıktısı \`ok:false + error\` olsun — model hatayı okuyup düzeltir; çıplak stack yasak.
+
+## GÜVENLİK + STİL
+
+- Şifre/API anahtarını ASLA stdout'a, log'a, skill'e yazma.
+- Ağ çağrılarında timeout kullan (\`https\` modülü + \`req.setTimeout\` veya fetch); sonsuz bekleyen script yazma.
+- Tek sorumluluk: bir tool = bir iş. Çok işli dev tool yazma — parçala.
+- Kullanıcıya tool'u nasıl yöneteceğini söyle: sol panelde TOOLLAR kutusunda test/düzenle/sil + 📂 klasör.`,
+  },
 ];
 
 function writeSeed(seed) {

package/src/main.js

@@ -3605,6 +3605,7 @@ app.whenReady().then(() => {
     reloadBackend();
     syncWhitelist(); // bot sistemi: whitelist.json aynası ilk açılışta garanti
     try { bots.ensureBotCodes(); } catch {} // her bota benzersiz 5 haneli kod garanti
+    try { customtools.seedIfEmpty(); } catch {} // kişisel toollar klasörü boşsa örnek tool kur
     createSplash();
     createWindow();
     log.info('main', 'Beast Agent başlatıldı');
@@ -5892,6 +5893,27 @@ ipcMain.handle('agents:cancel', (_e, id) => {
 /* AJAN DM paneli: ajanlar arası mesaj arşivi */
 ipcMain.handle('agent-dms:list', () => (engine ? engine.agentDmsList() : []));
 ipcMain.handle('agent-dms:clear', () => (engine ? engine.agentDmsClear() : { ok: false }));
+
+/* ---------- KİŞİSEL TOOLLAR (%APPDATA%\beast\tools\) ---------- */
+ipcMain.handle('tools:list', () => customtools.list());
+ipcMain.handle('tools:save', (_e, tool) => customtools.save(tool || {}));
+ipcMain.handle('tools:delete', (_e, id) => customtools.remove(id));
+ipcMain.handle('tools:run', async (_e, payload) => {
+  const id = String((payload && payload.id) || '');
+  const args = (payload && payload.args) || {};
+  const r = await customtools.call('tool__' + id, args);
+  return r;
+});
+ipcMain.handle('tools:openFolder', () => {
+  try {
+    const d = customtools.dir();
+    fs.mkdirSync(d, { recursive: true });
+    require('electron').shell.openPath(d);
+    return { ok: true };
+  } catch (e) {
+    return { ok: false, error: String((e && e.message) || e) };
+  }
+});
 ipcMain.handle('ceo:get', () => !!engine.ceoMode);
 ipcMain.handle('ceo:set', (_e, v) => {
   settings.ceoMode = !!v;
@@ -8273,6 +8295,7 @@ function studioWatchStop() {
    oturumu, tur tur piyasa tarayıp (farklı API/model seçilebilir) işlem kovalar. */
 const mt5bridge = require('./mt5bridge');
 const financetools = require('./agent/financetools');
+const customtools = require('./agent/customtools');
 
 const financeState = {
   mode: false, /* chat oturumları finance bayrağı alıyor mu */
@@ -8337,6 +8360,15 @@ try {
   });
 } catch {}
 
+/* KİŞİSEL TOOLLAR: çalışma kaydı renderer'a (TOOLS konsolu buradan beslenir) */
+try {
+  customtools.setNotify((entry) => {
+    try {
+      if (win && !win.isDestroyed()) win.webContents.send('agent:event', { type: 'tool-log', ...entry });
+    } catch {}
+  });
+} catch {}
+
 function financeEnsureBridge() {
   const f = finCfg();
   const candidates = [String(f.pythonPath || '').trim(), 'python', 'py -3'].filter(Boolean);
@@ -8695,23 +8727,32 @@ ipcMain.handle('finance:snapshot', async () => {
 ipcMain.handle('finance:mode', async (_e, payload) => {
   financeState.mode = !!(payload && payload.on);
   const sid = String((payload && payload.sessionId) || '');
+  let needNew = false;
   if (sid && engine) {
     try {
       let s = engine.cache.get(sid);
       if (!s) { try { s = engine._load(sid); } catch {} }
-      if (s && !s.botId && !s.bgJob) {
+      if (s && !s.bgJob && (!s.botId || s.botId === 'beast')) {
         if (financeState.mode) {
-          engine.markFinance(sid, false); /* kalıcı etiket: finance geçmişine girer */
-          finApplyTraderFields(s);
-          s.financeTrader = false; /* chat copilot'ı — trader değil */
+          if (s.finance) {
+            /* zaten finance oturumu — aynen sürdür */
+            finApplyTraderFields(s);
+            s.financeTrader = false; /* chat copilot'ı — trader değil */
+          } else {
+            /* NORMAL oturum (örn. WhatsApp sohbeti) finance modundayken ASLA
+               finance'e çevrilmez — ayrı bir finance oturumu açılır.
+               (eski davranış WhatsApp oturumunu da finance listesine karıştırıyordu) */
+            needNew = true;
+          }
         } else {
-          engine.unmarkFinance(sid); /* normal sohbete döner */
+          /* mod kapandı: aktif finance oturumu normal sohbete döner */
+          if (s.finance) engine.unmarkFinance(sid);
         }
         engine.cache.set(sid, s);
       }
     } catch {}
   }
-  return { ok: true, mode: financeState.mode };
+  return { ok: true, mode: financeState.mode, needNew };
 });
 
 /* MT5 sembol seçici: terminaldeki tüm semboller (isteğe bağlı *filter*) */

package/src/preload.js

@@ -22,6 +22,11 @@ contextBridge.exposeInMainWorld('beast', {
   agentsCancel: (id) => ipcRenderer.invoke('agents:cancel', id),
   agentDmsList: () => ipcRenderer.invoke('agent-dms:list'),
   agentDmsClear: () => ipcRenderer.invoke('agent-dms:clear'),
+  toolsList: () => ipcRenderer.invoke('tools:list'),
+  toolSave: (t) => ipcRenderer.invoke('tools:save', t),
+  toolDelete: (id) => ipcRenderer.invoke('tools:delete', id),
+  toolRun: (id, args) => ipcRenderer.invoke('tools:run', { id, args }),
+  toolsOpenFolder: () => ipcRenderer.invoke('tools:openFolder'),
   getCeoMode: () => ipcRenderer.invoke('ceo:get'),
   setCeoMode: (v) => ipcRenderer.invoke('ceo:set', v),
   listNotes: () => ipcRenderer.invoke('notes:list'),