beast-agent 0.26.4 → 0.27.0

package/package.json

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

package/src/agent/engine.js

@@ -19,6 +19,9 @@ const SUB_MAX_TURNS = 8;
 const HISTORY_TOKEN_BUDGET = 18000;
 const TOOL_OUT_KEEP = 1200;
 const USER_MAX = 8000;
+/* observe() ile enjekte edilen bağlam mesajlarının öneki — ardışık bağlam
+   mesajlarının tek mesajda birleşmesi bu işaretle anlaşılır */
+const OBSERVE_MARK = '[BAĞLAM';
 
 /* Oturum notları (geçici hafıza): eski mesajlar bütçeden düşülmeden önce
    önemli noktalar çıkarılır, sistem promptuna küçük blok olarak girer. */
@@ -1611,6 +1614,38 @@ class Engine {
     return true;
   }
 
+  /* SESSİZ BAĞLAM ENJEKSİYONU: metin oturum geçmişine düşer ama _run()
+     TETİKLENMEZ — ajan "görür", cevap ÜRETMEZ. WhatsApp gruplarında
+     @mention moduyla kullanılır: grubun tüm konuşması bağlam olarak
+     birikir, bot yalnız mention gelince konuşur. Ardışık bağlam
+     mesajları işaret önekli tek user mesajında birleşir (bazı sağlayıcılar
+     art arda user mesajını reddettiği için). */
+  observe(sessionId, text) {
+    const s = this._load(String(sessionId));
+    if (!s) return false;
+    const body = String(text || '').slice(0, USER_MAX);
+    if (!body.trim()) return false;
+    const lastMsg = s.messages[s.messages.length - 1];
+    if (
+      lastMsg && lastMsg.role === 'user' &&
+      typeof lastMsg.content === 'string' &&
+      lastMsg.content.startsWith(OBSERVE_MARK)
+    ) {
+      /* önceki bağlam mesajının devamı — tek mesajda birleştir */
+      lastMsg.content = (lastMsg.content + '\n' + body).slice(0, USER_MAX);
+      this._rewriteLastMsg(s.id, lastMsg.content);
+    } else {
+      const msg = { role: 'user', content: body };
+      s.messages.push(msg);
+      try {
+        this._append(s, msg);
+      } catch {}
+    }
+    this.emit({ type: 'observe', sessionId: s.id });
+    this.emit({ type: 'sessions' });
+    return true;
+  }
+
   /* #14 paralel ajanlar: ANA oturumu hiç bloklamayan arka plan çalıştırıcı.
      Ayrı gizli oturum açar, işi orada koşturur; bitince özet bildirim
      istenen sohbete düşer. Birden fazla iş aynı anda paralel koşabilir —
@@ -3850,3 +3885,4 @@ module.exports.BG_HIDDEN_TOOLS = BG_HIDDEN_TOOLS;
 module.exports.PERM_TOOL_SETS = PERM_TOOL_SETS;
 module.exports.PERM_LEVELS = PERM_LEVELS;
 module.exports.normalizePerms = normalizePerms;
+module.exports.OBSERVE_MARK = OBSERVE_MARK;

package/src/agent/whatsapp.js

@@ -337,8 +337,20 @@ class WhatsAppBridge {
   async _processIncoming(msg) {
     try {
       const jid = msg.key && msg.key.remoteJid;
-      if (!jid || msg.key.fromMe) return;
+      if (!jid) return;
       if (jid === 'status@broadcast' || jid.endsWith('@newsletter')) return;
+      /* botun kendi kimliği: telefon base'i + LID base'i (LID dönemi) */
+      const meBase = String(this._userIdRaw || '').split('@')[0].split(':')[0];
+      const lidBase = String((this.sock && this.sock.user && this.sock.user.lid) || '').split('@')[0].split(':')[0];
+      /* KENDİ KENDİNE SOHBET (Saved Messages): kullanıcı kendi numarasını izinliye
+         ekleyip kendi sohbetinden bota yazabilsin. Bu sohbetteki HER mesaj fromMe
+         gelir; botun KENDİ gönderdiği mesajlar (_tracked) filtrelenir → döngü yok.
+         Diğer sohbetlerdeki elle yazılan fromMe mesajları bot etkilenmesin diye yutulur. */
+      const selfChat = !!(meBase && (jid === meBase + '@s.whatsapp.net' || (lidBase && jid === lidBase + '@lid')));
+      if (msg.key.fromMe) {
+        if (this._tracked.has(String(msg.key.id))) return; // botun kendi cevabı — echo
+        if (!selfChat) return;
+      }
       const isGroup = jid.endsWith('@g.us');
       const participantJid = isGroup && msg.key.participant ? String(msg.key.participant) : '';
       const mm = msg.message || {};
@@ -351,20 +363,35 @@ class WhatsAppBridge {
       const t = String(text || '').trim();
 
       // gruplarda bot'un kendisi @mention edilmiş mi
+      /* LİD DÖNEMİ UYARISI: mentionedJid artık çoğu zaman botun @lid numarasıyla
+         gelir (telefon JID'i DEĞİL) — bu yüzden yalnız meBase ile karşılaştırma
+         mention'ı ıskalıyordu. Şimdi: botun telefon base'i + LID base'i ikisiyle
+         de eşitlik aranır; contextInfo görsel/video/belge caption'larından da alınır. */
       let mentioned = false;
       if (isGroup) {
-        const ci = mm.extendedTextMessage && mm.extendedTextMessage.contextInfo;
+        const ci =
+          (mm.extendedTextMessage && mm.extendedTextMessage.contextInfo) ||
+          (mm.imageMessage && mm.imageMessage.contextInfo) ||
+          (mm.videoMessage && mm.videoMessage.contextInfo) ||
+          (mm.documentMessage && mm.documentMessage.contextInfo) ||
+          null;
         const men = (ci && ci.mentionedJid) || [];
-        const meBase = String(this._userIdRaw || '').split('@')[0].split(':')[0];
+        const baseOf = (j) => String(j || '').split('?')[0].split(':')[0].split('@')[0];
         for (const m of men) {
-          if (meBase && String(m).split('?')[0].split(':')[0].includes(meBase)) {
+          const base = baseOf(m);
+          if (base && ((meBase && base === meBase) || (lidBase && base === lidBase))) {
             mentioned = true;
             break;
           }
         }
-        if (!mentioned && ci && ci.participant && meBase && String(ci.participant).includes(meBase)) {
-          mentioned = true; // mesajımıza reply verilmiş
+        if (!mentioned && ci && ci.participant) {
+          const pBase = baseOf(ci.participant);
+          if ((meBase && pBase === meBase) || (lidBase && pBase === lidBase)) {
+            mentioned = true; // mesajımıza reply verilmiş
+          }
         }
+        /* metin yedeği: @<bot numarası> elle yazılmışsa da mention sayılır */
+        if (!mentioned && meBase && t.includes('@' + meBase)) mentioned = true;
       }
 
       // medya çıkarımı (varsa)
@@ -406,6 +433,9 @@ class WhatsAppBridge {
         senderNum = (participantJid || jid).split('@')[0].split(':')[0];
         if (!/^\d+$/.test(senderNum)) senderNum = '';
       }
+      /* kendi kendine sohbette gönderen = botun telefon numarası — izin listesi
+         telefon numarasıyla eşleşsin (LID self-chat'te jid @lid olur) */
+      if (selfChat && meBase) senderNum = meBase;
       this.onIncoming(jid, {
         text: t,
         media,

package/src/main.js

@@ -7,7 +7,7 @@ const http = require('http');
 const dns = require('dns');
 const crypto = require('crypto');
 const { spawn } = require('child_process');
-const Engine = require('./agent/engine');
+const { Engine, OBSERVE_MARK } = require('./agent/engine');
 const { loadBeastConfig, beastDir } = require('./agent/config');
 const bots = require('./agent/bots');
 const mqueue = require('./agent/mqueue');
@@ -1199,6 +1199,75 @@ async function waFlush(jid) {
   }
 }
 
+/* Grup göndereninin kimlik etiketi + SAHİP olup olmadığı.
+   Sıra: izin listesindeki isim → @kullanıcı adı → gerçek PN → LID base.
+   hitP.owner → bu kişi izin listesinde SAHİP olarak işaretli. */
+function waGroupSenderInfo(payload) {
+  const pnDigits = String(payload.participantPn || '').split('@')[0].split(':')[0];
+  const hitP = /^\d+$/.test(pnDigits) ? waFind(pnDigits) : null;
+  const uname = String(payload.participantUsername || '').trim();
+  let label;
+  if (hitP && hitP.name) label = `${hitP.name} (+${pnDigits})`;
+  else if (uname) label = `@${uname}${/^\d+$/.test(pnDigits) ? ' (+' + pnDigits + ')' : ''}`;
+  else if (/^\d+$/.test(pnDigits)) label = '+' + pnDigits;
+  else label = payload.participant ? '+' + String(payload.participant).split('@')[0].split(':')[0] : '';
+  return { label, name: (hitP && hitP.name) || '', isOwner: !!(hitP && hitP.owner) };
+}
+
+/* Oturum yoksa oluştur (processWaMessage ile aynı kalıp) */
+function ensureWaSession(jid) {
+  let sid = waChats.get(jid);
+  if (!sid) {
+    const v = engine.createSession();
+    sid = v.id;
+    waChats.set(jid, sid);
+    saveWaChats();
+    if (wa) wa.setWatchJids([...waChats.keys()]);
+  } else {
+    waRememberSession(jid, sid);
+  }
+  return sid;
+}
+
+/* ---------- GRUP BAĞLAM AKIŞI (mentionOnly + seeAll) ----------
+   Bot grubun tüm konuşmasını okur ama CEVAP ÜRETMEZ; mesajlar sessizce
+   oturum geçmişine bağlam olarak düşer. @mention gelince bot tüm bu
+   bağlamı görerek konuşur. Anti-spam: aynı birleştirme penceresi. */
+const waCtxQueue = new Map(); // jid -> { timer, payloads[] }
+
+function waGroupObserve(jid, payload, senderNum) {
+  let q = waCtxQueue.get(jid);
+  if (!q) {
+    q = { payloads: [] };
+    waCtxQueue.set(jid, q);
+  }
+  q.payloads.push({ payload, senderNum });
+  clearTimeout(q.timer);
+  waLog(`grup bağlam: kuyruğa girdi jid=${waPrettyJid(jid)} toplam=${q.payloads.length}`);
+  q.timer = setTimeout(() => {
+    waCtxFlush(jid).catch((e) => waLog(`ctx flush KRASİ: ${String((e && e.stack) || e)}`));
+  }, WA_DEBOUNCE_MS);
+}
+
+async function waCtxFlush(jid) {
+  const q = waCtxQueue.get(jid);
+  if (!q) return;
+  waCtxQueue.delete(jid);
+  const sid = ensureWaSession(jid);
+  /* her satır gönderen etiketli olur — ajan kimin ne yazdığını izleyebilsin */
+  const lines = [];
+  for (const { payload } of q.payloads) {
+    if (!payload || !payload.text) continue;
+    const gi = waGroupSenderInfo(payload);
+    const who = gi.label || '?';
+    lines.push(`${who}: ${String(payload.text).slice(0, 1500)}`);
+  }
+  if (!lines.length) return;
+  const text = `${OBSERVE_MARK} — WhatsApp grup konuşması (cevap verme, sadece bilgi olarak sakla)]\n` + lines.join('\n').slice(0, 6000);
+  engine.observe(sid, text);
+  waLog(`grup bağlam: oturuma işlendi sid=${sid} satır=${lines.length}`);
+}
+
 /* ---------- WA'dan skill kurulumu ----------
    SKILL.md (veya *.skill.md) belgesi atılırsa skills altına kurulur. */
 
@@ -1549,7 +1618,15 @@ async function handleWaIncoming(jid, payload, senderNum) {
     if (isGroup) {
       const g = settings.waGroups || {};
       if (!g.enabled) return;
-      if (g.mentionOnly !== false && !payload.mentioned) return;
+      const mentionMode = g.mentionOnly !== false;
+      /* MENTION MODU + seeAll: bot grubun TÜM konuşmasını BAĞLAM olarak görür
+         ama yalnız @mention'da cevap üretir. seeAll VARSAYILAN KAPALI —
+         mention'sız mesajlar tamamen yutulur (gizlilik). */
+      if (mentionMode && !payload.mentioned && g.seeAll) {
+        waGroupObserve(jid, payload, senderNum);
+        return;
+      }
+      if (mentionMode && !payload.mentioned) return;
       waLog(`grup mesajı jid=${waPrettyJid(jid)} participant=+${senderNum || '?'} mention=${!!payload.mentioned}`);
     } else {
       const hit = waFind(senderNum);
@@ -1725,22 +1802,21 @@ async function processWaMessage(jid, payload, senderNum, requeues = 0) {
      Kimlik çözümleme sırası: izin listesindeki isim → @kullanıcı adı → gerçek PN → LID.
      Ajan böylece grubun içinde mesajın KİMDEN geldiğini görür. */
   let groupSender = '';
+  let groupSenderOwner = false;
   if (isGroup) {
-    const pnDigits = String(payload.participantPn || '').split('@')[0].split(':')[0];
-    const hitP = /^\d+$/.test(pnDigits) ? waFind(pnDigits) : null;
-    const uname = String(payload.participantUsername || '').trim();
-    if (hitP && hitP.name) groupSender = `${hitP.name} (+${pnDigits})`;
-    else if (uname) groupSender = `@${uname}${/^\d+$/.test(pnDigits) ? ' (+' + pnDigits + ')' : ''}`;
-    else if (/^\d+$/.test(pnDigits)) groupSender = '+' + pnDigits;
-    else groupSender = participantName || '';
+    const gi = waGroupSenderInfo(payload);
+    groupSender = gi.label || participantName;
+    groupSenderOwner = gi.isOwner;
   }
-  /* #v13.1 rol: SAHİP vs MİSAFİR — ajan kime konuştuğunu net bilsin */
+  /* #v13.1 rol: SAHİP vs MİSAFİR — ajan kime konuştuğunu net bilsin.
+     GRUPLARDA DA: gönderen izin listesinde SAHİP olarak işaretliyse ajan
+     bunu görür — sahibinin grup içi talepleri misafir sözünden önceliklidir. */
   const isOwner = !isGroup && !!hit.owner;
-  const roleTag = isOwner
+  const roleTag = isOwner || groupSenderOwner
     ? 'SAHİBİN (talepleri önceliklidir)'
     : 'MİSAFİR (izinli ama sahibin sözü önceliklidir)';
   const label = isGroup
-    ? `Grup ${jid.split('@')[0]}${groupSender ? ' — gönderen: ' + groupSender : ''}`
+    ? `Grup ${jid.split('@')[0]}${groupSender ? ` — gönderen: ${groupSender} — ${groupSenderOwner ? 'SAHİBİN' : 'MİSAFİR (grup üyesi)'}` : ''}`
     : hit.name
       ? `${hit.name} (+${senderNum || '?'}) — ${roleTag}`
       : `+${senderNum || '?'} — ${roleTag}`;
@@ -1748,7 +1824,9 @@ async function processWaMessage(jid, payload, senderNum, requeues = 0) {
   if (!isGroup && !isOwner) {
     text += `\n[NOT: Bu kişi SAHİP DEĞİL, misafirdir. Sahibin ayarlarını/verilerini değiştirme; kalıcı hafızaya misafire özel bilgi yazma.]`;
   } else if (isGroup) {
-    text += `\n[NOT: Grup mesajı — gönderen grubun üyesidir, izin listendeki kişi olmayabilir. Grup üyelerine karşı temkinli konuş.]`;
+    text += groupSenderOwner
+      ? `\n[NOT: Grup mesajı ama gönderen SAHİBİN — talepleri önceliklidir, misafir gibi temkinli konuşmana gerek yok.]`
+      : `\n[NOT: Grup mesajı — gönderen grubun üyesidir, izin listendeki kişi olmayabilir. Grup üyelerine karşı temkinli konuş.]`;
   }
   const attachments = [];
 
@@ -4551,12 +4629,16 @@ ipcMain.handle('wherewasi:set', (_e, cfg) => {
   return settings.whereWasI;
 });
 
-/* WhatsApp grup ayarı: { enabled, mentionOnly } */
-ipcMain.handle('wa:groups:get', () => settings.waGroups || { enabled: false, mentionOnly: true });
+/* WhatsApp grup ayarı: { enabled, mentionOnly, seeAll }
+   seeAll: yalnız mentionOnly modunda anlamlı — bot grubun TÜM konuşmasını
+   bağlam olarak okur ama yine SADECE @mention'da cevap verir.
+   VARSAYILAN KAPALI: herkesin konuşmasını görmesi istenmeyebilir. */
+ipcMain.handle('wa:groups:get', () => settings.waGroups || { enabled: false, mentionOnly: true, seeAll: false });
 ipcMain.handle('wa:groups:set', (_e, cfg) => {
   settings.waGroups = {
     enabled: !!(cfg && cfg.enabled),
     mentionOnly: !(cfg && cfg.mentionOnly === false),
+    seeAll: !!(cfg && cfg.seeAll),
   };
   saveSettings();
   return settings.waGroups;

package/src/renderer/i18n.js

@@ -195,8 +195,10 @@
       it_connect: 'QR ile Bağlan',
       it_disconnect: 'Kes',
       it_reset_pair: 'Eşlemeyi Sıfırla',
-      it_groups_on: 'WhatsApp gruplarında çalış — bot @mention edilince cevap verir',
-      it_groups_all: 'Mention şart değil: grup içindeki her mesaja karış',
+      it_groups_on: 'WhatsApp gruplarında çalış',
+      it_groups_mention: 'Sadece @mention edilince cevap ver (grupta botu etiketle)',
+      it_groups_seeall: 'Mention modunda grubun TÜM konuşmalarını oku (bağlam biriktirir, yine sadece @mention\'a cevap verir)',
+      it_groups_all: 'Grubun her mesajına karış',
       it_allow_label: 'İzinli numaralar',
       it_name_ph: 'İsim (zorunlu)',
       it_num_ph: 'Numara 905xxxxxxxxx',
@@ -723,8 +725,10 @@
       it_connect: 'Connect via QR',
       it_disconnect: 'Disconnect',
       it_reset_pair: 'Reset pairing',
-      it_groups_on: 'Work in WhatsApp groups — bot replies when @mentioned',
-      it_groups_all: 'Mention not required: respond to every group message',
+      it_groups_on: 'Work in WhatsApp groups',
+      it_groups_mention: 'Reply only when @mentioned (tag the bot in the group)',
+      it_groups_seeall: 'In mention mode, read ALL group messages as context (still replies only when @mentioned)',
+      it_groups_all: 'Respond to every group message',
       it_allow_label: 'Allowed numbers',
       it_name_ph: 'Name (required)',
       it_num_ph: 'Number 905xxxxxxxxx',

package/src/renderer/renderer.js

@@ -1473,7 +1473,7 @@ const WA_STATUS_TEXT = {
 
 async function renderIntegrationsPane() {
   const pane = $('#tab-integrations');
-  const g = await beast.waGetGroups().catch(() => ({ enabled: false, mentionOnly: true }));
+  const g = await beast.waGetGroups().catch(() => ({ enabled: false, mentionOnly: true, seeAll: false }));
   pane.innerHTML =
     '<h2>' + _t('it_h2') + '</h2><div class="sub">' + _t('it_sub') + '</div>' +
     `<div class="wa-card">
@@ -1498,7 +1498,9 @@ async function renderIntegrationsPane() {
       </div>
       <div style="height:14px"></div>
       <label class="lock-row"><input type="checkbox" id="waGroupsOn" ${g.enabled ? 'checked' : ''}/><span>${_t('it_groups_on')}</span></label>
-      <label class="lock-row" style="${g.enabled ? '' : 'opacity:.45'}"><input type="checkbox" id="waGroupsAll" ${g.mentionOnly === false ? 'checked' : ''}/><span>${_t('it_groups_all')}</span></label>
+      <label class="lock-row" style="${g.enabled ? '' : 'opacity:.45'}"><input type="radio" name="waGroupMode" id="waGroupsMention" ${g.mentionOnly !== false ? 'checked' : ''}/><span>${_t('it_groups_mention')}</span></label>
+      <label class="lock-row" style="${g.enabled ? '' : 'opacity:.45'}"><input type="radio" name="waGroupMode" id="waGroupsAll" ${g.mentionOnly === false ? 'checked' : ''}/><span>${_t('it_groups_all')}</span></label>
+      <label class="lock-row" id="waSeeAllRow" style="${g.enabled && g.mentionOnly !== false ? '' : 'opacity:.45'}"><input type="checkbox" id="waGroupsSeeAll" ${g.seeAll ? 'checked' : ''}/><span>${_t('it_groups_seeall')}</span></label>
       <div class="divider"></div>
       <label class="mem-label" style="margin-top:0">${_t('it_allow_label')}</label>
       <div id="waAllowChips" class="chips-inline"></div>
@@ -1571,16 +1573,44 @@ async function renderIntegrationsPane() {
     </div>`;
 
   const waGroupsOn = $('#waGroupsOn');
+  const waGroupsMention = $('#waGroupsMention');
   const waGroupsAll = $('#waGroupsAll');
+  const waGroupsSeeAll = $('#waGroupsSeeAll');
+  const waSeeAllRow = $('#waSeeAllRow');
+  /* iki mod BİRBİRİNE HARIÇTİR: ya @mention ya her mesaja karışma (radio)
+     seeAll yalnız mention modunda anlamlı — o mod seçiliyken aktifleşir */
+  const syncGroupMode = () => {
+    const op = waGroupsOn.checked ? '' : '.45';
+    if (waGroupsMention) waGroupsMention.parentElement.style.opacity = op;
+    if (waGroupsAll) waGroupsAll.parentElement.style.opacity = op;
+    if (waSeeAllRow) waSeeAllRow.style.opacity = waGroupsOn.checked && waGroupsMention && waGroupsMention.checked ? '' : '.45';
+  };
   const saveGroups = async () => {
-    const r = await beast.waSetGroups({ enabled: waGroupsOn.checked, mentionOnly: !waGroupsAll.checked });
-    toast(r.enabled ? (r.mentionOnly ? 'Gruplar açık — @mention bekler' : 'Gruplar açık — tüm mesajlara karışır') : 'Gruplar kapalı');
+    const r = await beast.waSetGroups({ enabled: waGroupsOn.checked, mentionOnly: !waGroupsAll.checked, seeAll: !!(waGroupsSeeAll && waGroupsSeeAll.checked) });
+    toast(
+      r.enabled
+        ? r.mentionOnly
+          ? r.seeAll
+            ? 'Gruplar açık — tüm konuşmalar bağlam olarak okunuyor, sadece @mention\'a cevap verir'
+            : 'Gruplar açık — @mention bekler'
+          : 'Gruplar açık — tüm mesajlara karışır'
+        : 'Gruplar kapalı'
+    );
   };
   waGroupsOn.addEventListener('change', async () => {
-    waGroupsAll.parentElement.style.opacity = waGroupsOn.checked ? '' : '.45';
+    syncGroupMode();
     await saveGroups();
   });
-  waGroupsAll.addEventListener('change', saveGroups);
+  waGroupsMention.addEventListener('change', () => {
+    syncGroupMode();
+    saveGroups();
+  });
+  waGroupsAll.addEventListener('change', () => {
+    syncGroupMode();
+    saveGroups();
+  });
+  if (waGroupsSeeAll) waGroupsSeeAll.addEventListener('change', saveGroups);
+  syncGroupMode();
 
   $('#waStartBtn').addEventListener('click', async () => {
     toast('Bağlanıyor…');

package/tests/engine.test.js

@@ -113,28 +113,91 @@ test('eski görseller metne indirilir, son mesajın görseli korunur', () => {
   assert.ok(Array.isArray(lastUser.content));
 });
 
-/* ---------- oturum notlar� (ge�ici haf�za) ---------- */
+/* ---------- oturum notlar� (ge�ici haf�za) ---------- */
 
-test('oturum notlar�: dosyadan y�klenir, mesaj listesine kar��maz', () => {
+test('oturum notlar�: dosyadan y�klenir, mesaj listesine kar��maz', () => {
   const eng = makeEngine();
   const id = eng.createSession().id;
   for (let i = 0; i < 5; i++) {
     fs.appendFileSync(eng._file(id), JSON.stringify({ t: 'msg', role: 'user', content: 'mesaj ' + i }) + '\n');
   }
-  fs.appendFileSync(eng._file(id), JSON.stringify({ t: 'notes', text: 'hedef: v7 �al�smas�', at: 3 }) + '\n');
-  eng.cache.delete(id); // diskten taze y�kle
+  fs.appendFileSync(eng._file(id), JSON.stringify({ t: 'notes', text: 'hedef: v7 �al�smas�', at: 3 }) + '\n');
+  eng.cache.delete(id); // diskten taze y�kle
   const s = eng._load(id);
-  assert.equal(s.notes, 'hedef: v7 �al�smas�');
+  assert.equal(s.notes, 'hedef: v7 �al�smas�');
   assert.equal(s.notesAt, 3);
   assert.equal(s.messages.length, 5);
 });
 
-test('oturum notlar� varken payload s�k�la��r', () => {
-  const eng = makeEngine({ historyTokenBudget: 100000 });
-  const msgs = [];
-  for (let i = 0; i < 30; i++) msgs.push({ role: 'user', content: 'kisa mesaj #' + i });
-  const withoutNotes = eng._buildPayload('sys', msgs, null);
-  const withNotes = eng._buildPayload('sys', msgs, '�zet: test');
-  assert.ok(withNotes.length < withoutNotes.length);
-  assert.equal(withNotes[withNotes.length - 1].content, 'kisa mesaj #29'); // son mesaj hep kal�r
+test('oturum notlar� varken payload s�k�la��r', () => {
+  const eng = makeEngine({ historyTokenBudget: 100000 });
+  const msgs = [];
+  for (let i = 0; i < 30; i++) msgs.push({ role: 'user', content: 'kisa mesaj #' + i });
+  const withoutNotes = eng._buildPayload('sys', msgs, null);
+  const withNotes = eng._buildPayload('sys', msgs, '�zet: test');
+  assert.ok(withNotes.length < withoutNotes.length);
+  assert.equal(withNotes[withNotes.length - 1].content, 'kisa mesaj #29'); // son mesaj hep kal�r
+});
+
+/* ---------- observe(): sessiz bağlam enjeksiyonu ---------- */
+
+test('observe: mesaj geçmişe düşer ama run tetiklenmez', async () => {
+  const events = [];
+  const eng = makeEngine({ emit: (ev) => events.push(ev) });
+  const id = eng.createSession().id;
+  const ok = eng.observe(id, '[BAĞLAM — grup] ali: selam');
+  assert.ok(ok);
+  const s = eng._load(id);
+  assert.equal(s.messages.length, 1);
+  assert.equal(s.messages[0].role, 'user');
+  assert.ok(s.messages[0].content.startsWith('[BAĞLAM'));
+  // _run tetiklenmedi: LLM hatası/done olayı yok
+  await new Promise((r) => setTimeout(r, 60));
+  assert.ok(!events.some((e) => e.type === 'error' || e.type === 'done'));
+  // observe olayı yayıldı
+  assert.ok(events.some((e) => e.type === 'observe' && e.sessionId === id));
+  // boş metin false
+  assert.equal(eng.observe(id, '   '), false);
+});
+
+test('observe: ardışık bağlam mesajları tek mesajda birleşir', () => {
+  const eng = makeEngine();
+  const id = eng.createSession().id;
+  eng.observe(id, '[BAĞLAM — grup] ali: selam');
+  eng.observe(id, '[BAĞLAM — grup] ayşe: nasılsın');
+  const s = eng._load(id);
+  assert.equal(s.messages.length, 1);
+  assert.ok(s.messages[0].content.includes('ali: selam'));
+  assert.ok(s.messages[0].content.includes('ayşe: nasılsın'));
+  // dosyaya da tek satır yazıldı
+  const lines = fs.readFileSync(eng._file(id), 'utf8').split('\n').filter((l) => l.trim());
+  const msgLines = lines.filter((l) => { try { return JSON.parse(l).t === 'msg'; } catch { return false; } });
+  assert.equal(msgLines.length, 1);
 });
+
+test('observe: normal user mesajıyla birleşmez', () => {
+  const eng = makeEngine();
+  const id = eng.createSession().id;
+  const s = eng._load(id);
+  s.messages.push({ role: 'user', content: 'gerçek soru' });
+  fs.appendFileSync(eng._file(id), JSON.stringify({ t: 'msg', role: 'user', content: 'gerçek soru' }) + '\n');
+  eng.observe(id, '[BAĞLAM — grup] ali: selam');
+  assert.equal(s.messages.length, 2);
+  assert.equal(s.messages[0].content, 'gerçek soru');
+  assert.ok(s.messages[1].content.startsWith('[BAĞLAM'));
+});
+
+test('send: mention mesajı bekleyen bağlam mesajıyla birleşir ve run başlar', async () => {
+  const events = [];
+  const eng = makeEngine({ emit: (ev) => events.push(ev) });
+  const id = eng.createSession().id;
+  eng.observe(id, '[BAĞLAM — grup] ali: selam\nayşe: nasılsın');
+  eng.send(id, { text: '@beast bana bugün hava nasıl?' });
+  const s = eng._load(id);
+  assert.equal(s.messages.length, 1);
+  assert.ok(s.messages[0].content.includes('ayşe: nasılsın'));
+  assert.ok(s.messages[0].content.includes('@beast bana bugün hava nasıl?'));
+  // run başladı → sağlayıcı yoksa hata olayı düşer (tetiklenme kanıtı)
+  await new Promise((r) => setTimeout(r, 120));
+  assert.ok(events.some((e) => e.type === 'error' || e.type === 'done'));
+});