beast-agent 0.22.0 → 0.23.0

package/package.json

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

package/src/agent/telegram.js

@@ -0,0 +1,155 @@
+'use strict';
+
+/* TELEGRAM KÖPRÜSÜ (FEATURE 3)
+   WhatsApp köprüsünün Telegram hali — bağımlılık yok (saf Node https):
+   - Bot API long polling (getUpdates) ile gelen mesajlar onIncoming'e düşer
+   - send(chatId, text) cevap döner; 4096 karakter sınırında bölerek gönderir
+   - Aynı allow list mantığı: main tarafındaki tgFind() listesindeki kişilere cevap verir */
+
+const https = require('https');
+
+const API_BASE = 'https://api.telegram.org/bot';
+const SEND_CHUNK = 3800; // Telegram mesaj sınırı 4096 — güvenli pay
+
+class TelegramBridge {
+  constructor({ token, emit, onIncoming }) {
+    this.token = String(token || '').trim();
+    this.emit = emit || (() => {});
+    this.onIncoming = onIncoming || null;
+    this.connected = false;
+    this.stopping = false;
+    this.status = 'disconnected';
+    this.offset = 0;
+    this.me = null;
+    this._req = null; // aktif long-poll isteği (iptal için)
+  }
+
+  _setStatus(status, user) {
+    this.status = status;
+    this.connected = status === 'connected';
+    this.emit({ type: 'status', status, user: user || null });
+  }
+
+  /* Bot API çağrısı — JSON POST, promise sarmalı */
+  api(method, body = {}, opts = {}) {
+    return new Promise((resolve, reject) => {
+      const payload = JSON.stringify(body);
+      const req = https.request(
+        `${API_BASE}${this.token}/${method}`,
+        {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(payload) },
+          timeout: opts.timeout || 15000,
+        },
+        (res) => {
+          let data = '';
+          res.setEncoding('utf8');
+          res.on('data', (c) => { data += c; });
+          res.on('end', () => {
+            try {
+              const j = JSON.parse(data || '{}');
+              if (j.ok) resolve(j.result);
+              else reject(new Error(`telegram ${method}: ${j.description || 'hata ' + res.statusCode}`));
+            } catch (e) {
+              reject(new Error(`telegram ${method}: bozuk yanıt`));
+            }
+          });
+        }
+      );
+      req.on('timeout', () => req.destroy(new Error('zaman aşımı')));
+      req.on('error', reject);
+      this._req = req;
+      req.write(payload);
+      req.end();
+    });
+  }
+
+  async start() {
+    if (!this.token) {
+      this._setStatus('error');
+      return false;
+    }
+    this.stopping = false;
+    this.offset = 0;
+    this._setStatus('connecting');
+    try {
+      const me = await this.api('getMe', {});
+      this.me = me;
+      this._setStatus('connected', '@' + (me.username || me.first_name || 'bot'));
+    } catch (e) {
+      this._setStatus('error');
+      throw e;
+    }
+    this._pollLoop().catch(() => {});
+    return true;
+  }
+
+  /* long polling döngüsü — bağlantı koparsa 3 sn bekleyip devam */
+  async _pollLoop() {
+    while (!this.stopping) {
+      try {
+        const updates = await this.api(
+          'getUpdates',
+          { timeout: 25, offset: this.offset, allowed_updates: ['message'] },
+          { timeout: 35000 }
+        );
+        if (this.stopping) break;
+        for (const u of Array.isArray(updates) ? updates : []) {
+          this.offset = Math.max(this.offset, (u.update_id || 0) + 1);
+          const msg = u.message;
+          if (!msg || !msg.text || !msg.from || msg.from.is_bot) continue;
+          const chatId = msg.chat && msg.chat.id;
+          if (chatId === undefined || chatId === null) continue;
+          const payload = {
+            text: String(msg.text).slice(0, 6000),
+            senderId: String(msg.from.id || ''),
+            username: String(msg.from.username || ''),
+            senderName: String(msg.from.first_name || msg.from.username || ''),
+            isGroup: !!(msg.chat && (msg.chat.type === 'group' || msg.chat.type === 'supergroup')),
+          };
+          try {
+            if (this.onIncoming) this.onIncoming(String(chatId), payload);
+          } catch {}
+        }
+      } catch (e) {
+        if (this.stopping) break;
+        this.emit({ type: 'poll-error', error: String((e && e.message) || e) });
+        await new Promise((r) => setTimeout(r, 3000));
+      }
+    }
+  }
+
+  async stop() {
+    this.stopping = true;
+    try { if (this._req) this._req.destroy(new Error('stop')); } catch {}
+    this._req = null;
+    this.connected = false;
+    this.status = 'disconnected';
+  }
+
+  snapshot() {
+    return {
+      status: this.status,
+      user: this.me ? '@' + (this.me.username || this.me.first_name || 'bot') : null,
+      connected: this.connected,
+    };
+  }
+
+  /* Metin gönder — 4096 sınırı için parçalara böl */
+  async send(chatId, text) {
+    const t = String(text || '');
+    if (!t.trim()) return false;
+    const chunks = [];
+    for (let i = 0; i < t.length; i += SEND_CHUNK) chunks.push(t.slice(i, i + SEND_CHUNK));
+    for (const part of chunks) {
+      await this.api('sendMessage', {
+        chat_id: chatId,
+        text: part,
+        disable_web_page_preview: true,
+      });
+    }
+    return true;
+  }
+}
+
+module.exports = { TelegramBridge };

package/src/main.js

@@ -4,6 +4,7 @@ const { app, BrowserWindow, WebContentsView, ipcMain, shell, dialog, Tray, Menu,
 const path = require('path');
 const fs = require('fs');
 const http = require('http');
+const dns = require('dns');
 const crypto = require('crypto');
 const { spawn } = require('child_process');
 const Engine = require('./agent/engine');
@@ -14,6 +15,7 @@ const memory = require('./agent/memory');
 const skillsMod = require('./agent/skills');
 const storeMod = require('./agent/store');
 const { WhatsAppBridge } = require('./agent/whatsapp');
+const { TelegramBridge } = require('./agent/telegram');
 const cron = require('./cron');
 const watchers = require('./agent/watchers');
 const usageMod = require('./agent/usage');
@@ -201,6 +203,8 @@ const SETTINGS_BACKUP_FILE = path.join(APP_DIR, 'settings.backup.json');
 const WA_AUTH_DIR = path.join(APP_DIR, 'wa-auth');
 const WA_CHATS_FILE = path.join(APP_DIR, 'wa-chats.json');
 const FALLOUT_CRASH_FILE = path.join(APP_DIR, 'fallout-crash.json');
+const CHAT_QUEUE_FILE = path.join(APP_DIR, 'chat_queue.json');
+const TG_CHATS_FILE = path.join(APP_DIR, 'tg-chats.json');
 
 for (const d of [APP_DIR, SESSIONS_DIR]) fs.mkdirSync(d, { recursive: true });
 
@@ -216,6 +220,10 @@ let waChats = new Map(); // jid -> aktif session id
 let waHistory = new Map(); // jid -> [sid,...] bu sohbete ait tüm oturumlar
 let waJidPn = new Map(); // jid -> gerçek telefon numarası (LID fallback için)
 const WA_HISTORY_CAP = 20;
+let tg = null;
+let tgChats = new Map(); // telegram chatId -> aktif session id
+let tgHistory = new Map(); // chatId -> [sid,...]
+const TG_HISTORY_CAP = 20;
 let tray = null;
 app.isQuitting = false;
 
@@ -450,6 +458,34 @@ function isWaAllowed(senderNum) {
   return !!waFind(senderNum);
 }
 
+/* ---------- TELEGRAM (FEATURE 3): allow list — WA ile aynı mantık ----------
+   Liste formatı: [{ id:'123456789' | '@kullanici_adi', name, perm, bot_id }, '*']
+   Eşleşme: sayısal ID birebir, @username büyük/küçük harf duyarsız. */
+function tgLog(line) {
+  try { log.info('telegram', line); } catch {}
+}
+
+function tgFind(senderId, username) {
+  const list = settings.tgAllow || [];
+  if (!list.length) return null; // boş liste = kimseye cevap yok
+  const id = String(senderId || '').trim();
+  const uname = String(username || '').replace(/^@/, '').toLowerCase();
+  for (const e of list) {
+    if (e === '*') return { id: '*', name: '' };
+    const eid = typeof e === 'string' ? e.trim() : String((e && e.id) || '').trim();
+    if (!eid) continue;
+    if (eid === '*') return { id: '*', name: '' };
+    if (eid.startsWith('@')) {
+      if (uname && eid.slice(1).toLowerCase() === uname) {
+        return typeof e === 'string' ? { id: eid, name: '' } : e;
+      }
+    } else if (id && eid === id) {
+      return typeof e === 'string' ? { id: eid, name: '' } : e;
+    }
+  }
+  return null;
+}
+
 /* Sahip: owner işaretli kayıt; yoksa listedeki ilk kişi. /allow ve /block
    yalnızca sahip tarafından kullanılabilir (yabancı DM kendi kendini ekleyemesin). */
 function waOwnerNum() {
@@ -1759,6 +1795,206 @@ function ensureWa() {
   return wa;
 }
 
+/* ---------- TELEGRAM ENTEGRASYONU (FEATURE 3) ----------
+   WhatsApp ile aynı akış: gelen mesaj → allow list kontrolü → oturuma bağla
+   (bot eşleme + granül izin) → engine.send; cevap done/error olayında geri
+   gider. Anti-spam: 4.5 sn birleştirme penceresi (WA ile aynı). */
+
+(function tgChatsLoad() {
+  try {
+    const raw = JSON.parse(fs.readFileSync(TG_CHATS_FILE, 'utf8'));
+    if (raw && typeof raw.chats === 'object') {
+      for (const [c, s] of Object.entries(raw.chats)) {
+        if (typeof s === 'string') tgChats.set(c, s);
+      }
+    }
+    if (raw && typeof raw.history === 'object') {
+      for (const [c, arr] of Object.entries(raw.history)) {
+        if (Array.isArray(arr)) tgHistory.set(c, arr.filter((x) => typeof x === 'string').slice(-TG_HISTORY_CAP));
+      }
+    }
+    for (const [c, s] of tgChats.entries()) {
+      const h = tgHistory.get(c) || [];
+      if (!h.includes(s)) h.push(s);
+      tgHistory.set(c, h.slice(-TG_HISTORY_CAP));
+    }
+  } catch {}
+})();
+
+function saveTgChats() {
+  try {
+    fs.writeFileSync(
+      TG_CHATS_FILE,
+      JSON.stringify({
+        chats: Object.fromEntries(tgChats),
+        history: Object.fromEntries([...tgHistory.entries()].map(([c, a]) => [c, a.slice(-TG_HISTORY_CAP)])),
+      })
+    );
+  } catch {}
+}
+
+function tgRememberSession(chatId, sid) {
+  const h = tgHistory.get(chatId) || [];
+  if (!h.includes(sid)) h.push(sid);
+  tgHistory.set(chatId, h.slice(-TG_HISTORY_CAP));
+}
+
+const TG_DEBOUNCE_MS = 4500;
+const tgQueue = new Map(); // chatId -> { timer, payloads[] }
+
+function tgQueuePush(chatId, payload) {
+  let q = tgQueue.get(chatId);
+  if (!q) {
+    q = { payloads: [] };
+    tgQueue.set(chatId, q);
+  }
+  q.payloads.push(payload);
+  clearTimeout(q.timer);
+  tgLog(`queue: mesaj kuyruğa girdi chat=${chatId} toplam=${q.payloads.length} (4.5 sn birleştirme)`);
+  q.timer = setTimeout(() => {
+    tgFlush(chatId).catch((e) => tgLog(`flush KRASİ: ${String((e && e.stack) || e)}`));
+  }, TG_DEBOUNCE_MS);
+}
+
+async function tgFlush(chatId) {
+  const q = tgQueue.get(chatId);
+  if (!q) return;
+  tgQueue.delete(chatId);
+  const merged = { text: '', senderId: '', username: '', senderName: '' };
+  for (const p of q.payloads) {
+    if (p.text) merged.text += (merged.text ? '\n' : '') + p.text;
+    if (!merged.senderId && p.senderId) { merged.senderId = p.senderId; merged.username = p.username; merged.senderName = p.senderName; }
+  }
+  await processTgMessage(chatId, merged);
+}
+
+async function handleTgIncoming(chatId, payload) {
+  try {
+    if (!engine) return;
+    /* v1: yalnız birebir sohbetler — grup davranışı WA'daki gibi ayrı toggle ile gelir */
+    if (payload.isGroup) {
+      tgLog(`skip: grup mesajı chat=${chatId} (grup desteği kapalı)`);
+      return;
+    }
+    const hit = tgFind(payload.senderId, payload.username);
+    tgLog(
+      `incoming chat=${chatId} sender=${payload.senderId || '?'} user=${payload.username || '-'} allowed=${!!hit}` +
+        (hit && hit.name ? ' name=' + hit.name : '')
+    );
+    if (!hit) return; // allowlist dışı yoksay
+    /* İsimsiz kayıt: güvenlik için cevap verme — kullanıcıyı ayarlara yönlendir */
+    if (hit.id !== '*' && !hit.name) {
+      tgLog(`skip: isimsiz kayıt (${hit.id}) — cevap verilmedi, Entegrasyonlar'da isim ekle`);
+      return;
+    }
+    resumeServices(); // pause durumunda gelen mesaj servisleri canlandırır
+    tgQueuePush(String(chatId), payload);
+  } catch (e) {
+    tgLog(`handleTgIncoming KRASİ: ${String((e && e.stack) || e)}`);
+  }
+}
+
+async function processTgMessage(chatId, payload, requeues = 0) {
+  const hit = tgFind(payload.senderId, payload.username);
+  if (!hit) {
+    tgLog(`skip flush: izinli eşleşme yok (sender=${payload.senderId || '?'})`);
+    return;
+  }
+  let sid = tgChats.get(chatId);
+  if (sid && engine.isBusy(sid)) {
+    /* oturum meşgul — WA ile aynı: kaybetme, iş bitene dek yeniden dene */
+    await new Promise((r) => setTimeout(r, TG_DEBOUNCE_MS));
+    return processTgMessage(chatId, payload, requeues + 1);
+  }
+  if (!sid) {
+    const v = engine.createSession();
+    sid = v.id;
+    tgChats.set(chatId, sid);
+    tgRememberSession(chatId, sid);
+    saveTgChats();
+  } else {
+    tgRememberSession(chatId, sid);
+  }
+  /* Kişi bazlı granül izin: all/web/read/chat */
+  let perm = hit.perm || (hit.lockdown ? 'chat' : 'all');
+  engine.setSessionPerm(sid, perm);
+
+  /* BOT SİSTEMİ: izinli kayıtta bot_id yoksa beast'e düşer (WA ile aynı) */
+  let botId = hit && hit.bot_id ? String(hit.bot_id) : 'beast';
+  if (!bots.get(botId)) {
+    if (botId !== 'beast') tgLog(`bot="${botId}" yok — kayıt botsuz, beast (admin) botuna yönlendirildi`);
+    botId = 'beast';
+  }
+  engine.setSessionBot(sid, botId);
+  const botCfg = bots.get(botId);
+  if (botCfg && !botCfg.admin) {
+    const eff = moreRestrictivePerm(perm, botCfg.perm || 'all');
+    if (eff !== perm) {
+      perm = eff;
+      engine.setSessionPerm(sid, eff);
+    }
+    engine.setSessionTools(sid, botToolSet(botCfg));
+  } else {
+    engine.setSessionTools(sid, null);
+  }
+  tgLog(`perm=${fmtPerm(perm)} bot=${botId} sid=${sid}`);
+
+  /* #v13.1 rol: SAHİP vs MİSAFİR — ajan kime konuştuğunu net bilsin */
+  const isOwner = !!hit.owner;
+  const roleTag = isOwner
+    ? 'SAHİBİN (talepleri önceliklidir)'
+    : 'MİSAFİR (izinli ama sahibin sözü önceliklidir)';
+  const label =
+    (hit.name || payload.senderName || '?') +
+    (payload.username ? ` (@${payload.username})` : '') +
+    ` — ${roleTag}`;
+  let text = `[Telegram — gönderen: ${label}]`;
+  if (!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.]`;
+  }
+  text += `\n${String(payload.text || '').slice(0, 6000)}`;
+  engine.send(sid, { text: text.slice(0, 8000), attachments: [] });
+}
+
+async function sendTgSafe(chatId, text) {
+  if (!tg) return false;
+  try {
+    return !!(await tg.send(chatId, text));
+  } catch (e) {
+    tgLog(`send hata chat=${chatId}: ${String((e && e.message) || e)}`);
+    return false;
+  }
+}
+
+function ensureTg() {
+  if (!tg) {
+    tg = new TelegramBridge({
+      token: settings.tgToken || '',
+      emit: (ev) => {
+        if (ev.type === 'status') tgLog(`status=${ev.status}${ev.user ? ' user=' + ev.user : ''}`);
+        if (win && !win.isDestroyed()) win.webContents.send('tg:event', ev);
+      },
+      onIncoming: handleTgIncoming,
+    });
+  }
+  return tg;
+}
+
+/* token değişimi / yeniden başlatma: eski köprüyü kapat, yenisini aç */
+async function restartTg() {
+  if (tg) {
+    try { await tg.stop(); } catch {}
+    tg = null;
+  }
+  if (!settings.tgToken) return;
+  const b = ensureTg();
+  try {
+    await b.start();
+  } catch (e) {
+    tgLog(`start başarısız: ${String((e && e.message) || e)}`);
+  }
+}
+
 function reloadBackend() {
   if (engine && typeof engine.dispose === 'function') {
     try { engine.dispose(); } catch {}
@@ -1886,6 +2122,27 @@ function reloadBackend() {
           })();
         }
       }
+      // Telegram oturumlarının son cevabını geri gönder (WA ile aynı akış)
+      if ((ev.type === 'done' || ev.type === 'error') && tg && tg.connected) {
+        const hitT = [...tgChats.entries()].find(([, s]) => s === ev.sessionId);
+        if (hitT) {
+          const tgid = hitT[0];
+          (async () => {
+            try {
+              if (ev.type === 'error') {
+                await sendTgSafe(tgid, 'Bir aksilik oldu: ' + String(ev.error || '').slice(0, 200));
+                return;
+              }
+              if (!ev.aborted) {
+                const s = engine.openSession(ev.sessionId);
+                const lastA = [...s.messages].reverse().find((m) => m.role === 'assistant' && m.content);
+                const txt = typeof (lastA && lastA.content) === 'string' ? lastA.content : '';
+                if (txt.trim()) await sendTgSafe(tgid, txt);
+              }
+            } catch {}
+          })();
+        }
+      }
     },
   });
   return engine.publicState();
@@ -2042,6 +2299,10 @@ app.whenReady().then(() => {
     startNpmUpdateWatch(); // npm kurulumunda registry üzerinden otomatik sürüm kontrolü
     /* FEATURE 2: offline kuyruk işçisi — 30 sn'de bir bağlantı kontrolü + kuyruk boşaltma */
     setInterval(() => { mqueueTick().catch(() => {}); }, 30000).unref();
+    /* OFFLINE MESAJ KUYRUĞU: gerçek bağlantı yoklaması — 8 sn'de bir DNS probe.
+       Bağlantı dönünce kuyruktaki chat mesajları otomatik gönderilir. */
+    netCheck().catch(() => {});
+    setInterval(() => { netCheck().catch(() => {}); }, NET_CHECK_MS).unref();
 
     // #12 STT prefetch: whisper modelini arka planda hazırla (ilk sesli mesajda bekleme olmasın)
     if (settings.sttPrefetch !== false) {
@@ -2055,6 +2316,11 @@ app.whenReady().then(() => {
     // WhatsApp köprüsünü otomatik başlat (eşleme varsa direkt bağlanır)
     ensureWa().start().catch((e) => waLog('autostart failed: ' + (e && e.message)));
 
+    // Telegram köprüsünü otomatik başlat (token kayıtlıysa)
+    if (settings.tgToken) {
+      ensureTg().start().catch((e) => tgLog('autostart failed: ' + String((e && e.message) || e)));
+    }
+
     app.on('activate', () => {
       if (BrowserWindow.getAllWindows().length === 0) createWindow();
     });
@@ -3223,6 +3489,12 @@ function queueDesktopMessage(sessionId, text) {
   const t = isObj ? String((text && text.text) || '') : String(text ?? '');
   const hasAtts = isObj && Array.isArray(text.attachments) && text.attachments.length > 0;
   if (!sid || (!t.trim() && !hasAtts)) return; // boş içerik kuyruğa girmez
+  /* FEATURE: OFFLINE MESAJ KUYRUĞU — internet yokken gelen mesaj diskte bekler,
+     bağlantı geri gelince otomatik gönderilir */
+  if (!netOnline) {
+    chatQueueOfflineAdd(sid, { text: t, attachments: hasAtts ? text.attachments : undefined });
+    return;
+  }
   let q = desktopQueue.get(sid);
   if (!q) {
     q = { timer: null, msgs: [] };
@@ -3250,6 +3522,13 @@ async function flushDesktop(sessionId) {
     return;
   }
   if (engine.isBusy(sid)) return; // hâlâ çalışıyor — done eventini bekle
+  /* debounce penceresinde internet koptuysa mesajlar offline kuyruğa düşer */
+  if (!netOnline) {
+    desktopQueue.delete(sid);
+    clearTimeout(q.timer);
+    for (const m of q.msgs) chatQueueOfflineAdd(sid, { text: m.text, attachments: m.attachments });
+    return;
+  }
   desktopQueue.delete(sid);
   clearTimeout(q.timer);
 
@@ -3276,6 +3555,144 @@ function flushDesktopOnDone(ev) {
   }
 }
 
+/* ---------- OFFLINE MESAJ KUYRUĞU (masaüstü sohbet) ----------
+   İnternet yokken/kopukken gönderilen chat mesajları kaybolmasın:
+   - Mesaj diskteki kuyruğa yazılır (chat_queue.json — elektrik kesintisine dayanıklı)
+   - Bağlantı geri gelince (DNS kontrolü) sırayla otomatik gönderilir
+   - Renderer'a 'net' / 'netQueue' olayları gider: ⏳ kuyruk balonu + toast */
+const NET_CHECK_HOSTS = ['one.one.one.one', 'dns.google'];
+const NET_CHECK_MS = 8000;
+const NET_CHECK_TIMEOUT = 4000;
+const CHAT_QUEUE_MAX = 50; // kuyruk üst sınırı — taşarsa en eski düşer
+
+let netOnline = true; // son bilinen bağlantı durumu (başlangıçta iyimser)
+let netCheckedOnce = false;
+let netCheckBusy = false;
+let chatQueueFlushing = false;
+const chatOfflineQueue = []; // { key, sessionId, text, attachments, at }
+
+/* diskten yükle (app restart sonrası kuyruk korunur) */
+(function chatQueueLoad() {
+  try {
+    const j = JSON.parse(fs.readFileSync(CHAT_QUEUE_FILE, 'utf8'));
+    const items = Array.isArray(j.items) ? j.items : [];
+    for (const it of items) {
+      if (it && typeof it === 'object' && it.sessionId && (String(it.text || '').trim() || (Array.isArray(it.attachments) && it.attachments.length))) {
+        chatOfflineQueue.push(it);
+      }
+    }
+  } catch {}
+})();
+
+function chatQueueSave() {
+  try {
+    const tmp = CHAT_QUEUE_FILE + '.tmp';
+    fs.writeFileSync(tmp, JSON.stringify({ items: chatOfflineQueue }, null, 2));
+    fs.renameSync(tmp, CHAT_QUEUE_FILE); // atomik yazım — yarı kalmış dosya olmaz
+  } catch {}
+}
+
+function chatQueueEmit(extra = {}) {
+  try {
+    if (win && !win.isDestroyed()) {
+      win.webContents.send('agent:event', {
+        type: 'netQueue',
+        online: netOnline,
+        count: chatOfflineQueue.length,
+        ...extra,
+      });
+    }
+  } catch {}
+}
+
+/* gönderilemeyen mesajı kuyruğa al */
+function chatQueueOfflineAdd(sessionId, { text, attachments }) {
+  const item = {
+    key: 'oq' + Date.now().toString(36) + Math.random().toString(36).slice(2, 6),
+    sessionId: String(sessionId || ''),
+    text: String(text || '').slice(0, 100000),
+    attachments: Array.isArray(attachments) ? attachments.slice(0, 5) : undefined,
+    at: new Date().toISOString(),
+  };
+  chatOfflineQueue.push(item);
+  while (chatOfflineQueue.length > CHAT_QUEUE_MAX) chatOfflineQueue.shift();
+  chatQueueSave();
+  log.info('main', `offline kuyruk: mesaj eklendi (${chatOfflineQueue.length} bekliyor) sid=${item.sessionId}`);
+  chatQueueEmit({
+    queued: true,
+    key: item.key,
+    sessionId: item.sessionId,
+    text: item.text,
+    attCount: item.attachments ? item.attachments.length : 0,
+  });
+}
+
+/* kuyruğu normal akışa (debounce → engine) verir */
+async function flushChatQueue() {
+  if (chatQueueFlushing) return;
+  if (!chatOfflineQueue.length) return;
+  if (!netOnline) return;
+  chatQueueFlushing = true;
+  try {
+    const keys = [];
+    while (chatOfflineQueue.length) {
+      const it = chatOfflineQueue.shift();
+      keys.push(it.key);
+      const payload = it.attachments && it.attachments.length ? { text: it.text, attachments: it.attachments } : it.text;
+      queueDesktopMessage(it.sessionId, payload);
+    }
+    chatQueueSave();
+    if (keys.length) {
+      log.info('main', `offline kuyruk boşaltıldı: ${keys.length} mesaj gönderiliyor`);
+      chatQueueEmit({ flushed: keys.length, keys });
+    }
+  } finally {
+    chatQueueFlushing = false;
+  }
+}
+
+/* gerçek internet kontrolü: DNS çözümlemesi (sadece ağ arayüzü değil,
+   paket gerçekten çıkıyor mu test eder). Adaylar sırayla denenir. */
+function dnsProbe(host) {
+  return new Promise((resolve) => {
+    const t = setTimeout(() => resolve(false), NET_CHECK_TIMEOUT);
+    dns.resolve(host, 'A', (err) => {
+      clearTimeout(t);
+      resolve(!err);
+    });
+  });
+}
+
+async function netCheck() {
+  if (netCheckBusy) return;
+  netCheckBusy = true;
+  try {
+    let ok = false;
+    for (const h of NET_CHECK_HOSTS) {
+      if (await dnsProbe(h)) { ok = true; break; }
+    }
+    const first = !netCheckedOnce;
+    const was = netOnline;
+    netOnline = ok;
+    netCheckedOnce = true;
+    if (was !== ok || first) {
+      try {
+        if (win && !win.isDestroyed()) win.webContents.send('agent:event', { type: 'net', online: ok });
+      } catch {}
+      if (ok) {
+        log.info('main', 'bağlantı geri geldi — offline kuyruk kontrol ediliyor');
+        chatQueueEmit(); // renderer: pill/toast güncellensin
+        flushChatQueue().catch(() => {});
+      } else {
+        log.info('main', 'internet bağlantısı yok — mesajlar kuyruğa alınacak');
+        chatQueueEmit();
+      }
+    }
+  } catch {} finally {
+    netCheckBusy = false;
+  }
+}
+
 ipcMain.handle('model:set', (_e, sel) => {
   settings.modelOverride = sel;
   saveSettings();
@@ -4796,6 +5213,43 @@ ipcMain.handle('wa:tts:set', (_e, cfg) => {
   return settings.waTts;
 });
 
+/* ---------- Telegram IPC (FEATURE 3) ---------- */
+
+ipcMain.handle('tg:status:get', () => {
+  if (!tg) return { configured: !!settings.tgToken, status: 'disconnected', user: null, connected: false };
+  return { configured: true, ...tg.snapshot() };
+});
+
+/* token kaydet + köprüyü (yeniden) başlat */
+ipcMain.handle('tg:set', async (_e, token) => {
+  const t = String(token || '').trim();
+  if (t) settings.tgToken = t;
+  saveSettings();
+  await restartTg();
+  return { configured: !!settings.tgToken, ...(tg ? tg.snapshot() : { status: 'disconnected', user: null }) };
+});
+
+ipcMain.handle('tg:start', async () => {
+  if (!settings.tgToken) return { ok: false, error: 'token yok — önce bot tokenı gir' };
+  await restartTg();
+  return { ok: true, ...(tg ? tg.snapshot() : {}) };
+});
+
+ipcMain.handle('tg:stop', async () => {
+  if (tg) {
+    try { await tg.stop(); } catch {}
+  }
+  return { ok: true };
+});
+
+ipcMain.handle('tg:allow:get', () => settings.tgAllow || []);
+ipcMain.handle('tg:allow:set', (_e, list) => {
+  settings.tgAllow = Array.isArray(list) ? list : [];
+  saveSettings();
+  return settings.tgAllow;
+});
+ipcMain.handle('tg:sessions', () => [...tgChats.values()]);
+
 /* ---------- e-posta IPC ---------- */
 
 ipcMain.handle('email:get', () => {

package/src/preload.js

@@ -115,6 +115,14 @@ contextBridge.exposeInMainWorld('beast', {
   waSetTts: (cfg) => ipcRenderer.invoke('wa:tts:set', cfg),
   waGetGroups: () => ipcRenderer.invoke('wa:groups:get'),
   waSetGroups: (cfg) => ipcRenderer.invoke('wa:groups:set', cfg),
+  tgGetStatus: () => ipcRenderer.invoke('tg:status:get'),
+  tgSetToken: (token) => ipcRenderer.invoke('tg:set', token),
+  tgStart: () => ipcRenderer.invoke('tg:start'),
+  tgStop: () => ipcRenderer.invoke('tg:stop'),
+  tgGetAllow: () => ipcRenderer.invoke('tg:allow:get'),
+  tgSetAllow: (list) => ipcRenderer.invoke('tg:allow:set', list),
+  tgListSessions: () => ipcRenderer.invoke('tg:sessions'),
+  onTgEvent: (cb) => ipcRenderer.on('tg:event', (_e, ev) => cb(ev)),
   getUsage: () => ipcRenderer.invoke('usage:get'),
   resetUsage: () => ipcRenderer.invoke('usage:reset'),
   createBackup: () => ipcRenderer.invoke('backup:create'),

package/src/renderer/i18n.js

@@ -200,6 +200,13 @@
       it_num_ph: 'Numara 905xxxxxxxxx',
       it_add: 'Ekle',
       it_allow_note: 'İsim + numara zorunlu. Her kişinin yanındaki serbest/web/okuma/kısıtlı seçimiyle kişiye özel yetki ver.',
+      it_tg_sub: 'Bot tokenı ile çalışır — izin listendeki kişilere Telegram\u2019dan cevap verir',
+      it_tg_token_ph: 'Bot tokenı (örn. 123456789:AAH…)',
+      it_tg_save: 'Kaydet & Bağlan',
+      it_tg_connecting: 'Telegram\u2019a bağlanıyor…',
+      it_tg_token_bad: 'Token doğrulanamadı — @BotFather\u2019dan aldığın tokenı kontrol et',
+      it_tg_id_ph: 'Kullanıcı ID veya @kullanıcı_adı',
+      it_tg_note: 'İzin listesi boşsa kimse cevap almaz. Bot oluşturma: @BotFather → /newbot. Kendi ID\u2019ni öğrenmek için @userinfobot\u2019a mesaj at.',
       ev_h2: 'Olay Merkezi',
       ev_sub: 'Cron\u2019suz canlı olaylar — kaynakları aç, abonelikleri agent kendisi kurar (event_subscribe). Tetiklenen olay ilgili sohbete düşer, cevap WhatsApp\u2019a gider.',
       ev_on: 'Olay merkezi açık',
@@ -452,6 +459,12 @@
       p_zen_ok: '${n} free model yüklendi',
       p_zen_skipped: '${n} model yanıt vermedi, listeye alınmadı',
       p_zen_fail: 'Model kurulumu başarısız',
+      net_offline: 'İnternet bağlantısı yok — mesajların kuyruğa alındı',
+      net_online: 'Bağlantı geri geldi',
+      net_pill_offline: 'İnternet yok — ${n} mesaj kuyrukta',
+      net_pill_online: 'İnternet yok',
+      q_pending: 'kuyrukta — internet bekleniyor',
+      q_flushed: '${n} kuyruktaki mesaj gönderiliyor',
       bot_num_ro_hint: 'Numara ekleme/kişi adı Ayarlar → Entegrasyonlar (WhatsApp izin listesi) üzerinden yapılır; burada yalnızca bağlı numaralar görünür.',
       tipStore: 'Skills Store',
       tipIde: 'IDE Modu — dosyalar + chat + preview',
@@ -701,6 +714,13 @@
       it_num_ph: 'Number 905xxxxxxxxx',
       it_add: 'Add',
       it_allow_note: 'Name + number required. Grant per-person permission (free/web/read/restricted) via the selector next to each.',
+      it_tg_sub: 'Works with a bot token — replies on Telegram to people in your allow list',
+      it_tg_token_ph: 'Bot token (e.g. 123456789:AAH…)',
+      it_tg_save: 'Save & Connect',
+      it_tg_connecting: 'Connecting to Telegram…',
+      it_tg_token_bad: 'Token could not be verified — check the token from @BotFather',
+      it_tg_id_ph: 'User ID or @username',
+      it_tg_note: 'Empty allow list = nobody gets a reply. Create a bot: @BotFather → /newbot. To learn your ID, message @userinfobot.',
       ev_h2: 'Event Center',
       ev_sub: 'Live events without cron — open sources, the agent sets up subscriptions itself (event_subscribe). The triggered event drops into the relevant chat, the reply goes to WhatsApp.',
       ev_on: 'Event center on',
@@ -1011,6 +1031,12 @@
       p_zen_ok: '${n} free models installed',
       p_zen_skipped: '${n} models did not respond, excluded',
       p_zen_fail: 'Model setup failed',
+      net_offline: 'No internet connection — messages queued',
+      net_online: 'Connection restored',
+      net_pill_offline: 'No internet — ${n} message(s) queued',
+      net_pill_online: 'No internet',
+      q_pending: 'queued — waiting for internet',
+      q_flushed: '${n} queued message(s) being sent',
       bot_num_ro_hint: 'Add numbers / person names via Settings → Integrations (WhatsApp allow list); only linked numbers are shown here.',
       tipStore: 'Skills Store',
       tipIde: 'IDE Mode — files + chat + preview',

package/src/renderer/renderer.js

@@ -193,6 +193,72 @@ function setStatus(text) {
   els.statusPill.textContent = text;
 }
 
+/* ---------------- OFFLINE MESAJ KUYRUĞU (chat) ----------------
+   İnternet yokken gönderilen mesajlar main'deki diske yazılan kuyruğa düşer;
+   burada ⏳ "kuyrukta" balonu gösterilir. Bağlantı gelince kuyruk otomatik
+   boşaltılır ('netQueue flushed') ve balonlar gerçek mesajla değişir. */
+let netOnline = true;
+let netQueueCount = 0;
+const netPending = []; // { key, el } — bekleyen mesaj balonları
+
+function setNetBadge(el, text) {
+  if (!el || !el.isConnected) return;
+  let badge = el.querySelector('.q-badge');
+  if (!badge) {
+    badge = document.createElement('span');
+    badge.className = 'q-badge';
+    el.appendChild(badge);
+  }
+  badge.textContent = '⏳ ' + text;
+}
+
+function updateNetQueueUi() {
+  if (busy) return;
+  if (!netOnline) {
+    setStatus(netQueueCount > 0 ? _ti('net_pill_offline', netQueueCount) : _t('net_pill_online'));
+  } else if (!netQueueCount) {
+    setStatus('');
+  }
+}
+
+function onNetEvent(ev) {
+  if (ev.type === 'net') {
+    const was = netOnline;
+    netOnline = ev.online !== false;
+    if (was !== netOnline) {
+      if (netOnline) {
+        toast(_t('net_online'));
+        if (!netQueueCount) setStatus('');
+      } else {
+        toast(_t('net_offline'));
+        updateNetQueueUi();
+      }
+    }
+    return;
+  }
+  if (ev.type === 'netQueue') {
+    netQueueCount = typeof ev.count === 'number' ? ev.count : netQueueCount;
+    if (ev.queued) {
+      if (ev.sessionId === activeId) {
+        addUserBubble(ev.text || (ev.attCount ? `[${ev.attCount} ek]` : ''));
+        const el = els.msgs.querySelector('.msg-user:last-of-type');
+        if (el && ev.key) {
+          setNetBadge(el, _t('q_pending'));
+          netPending.push({ key: ev.key, el });
+        }
+      }
+    } else if (ev.flushed) {
+      /* kuyruk boşaltılıyor: ⏳ balonlarını kaldır — gerçek mesaj echo ile gelir */
+      for (const p of netPending) {
+        if (p.el && p.el.isConnected) p.el.remove();
+      }
+      netPending.length = 0;
+      toast(_ti('q_flushed', ev.flushed));
+    }
+    updateNetQueueUi();
+  }
+}
+
 const TODO_GLYPH = { done: '✓', active: '▸', pending: '○' };
 
 function renderTodos(items) {
@@ -878,7 +944,7 @@ async function renderProviderPane() {
   form.innerHTML =
     /* TEK TİKLA MODEL (OpenCode Zen Free) */
     `<div class="zen-hero">` +
-    `<button id="zenOneClick" class="btn">⚡ ${_t('p_zen_btn')}</button>` +
+    `<button id="zenOneClick" class="btn"><span class="zen-load" hidden></span><span class="zen-label">⚡ ${_t('p_zen_btn')}</span></button>` +
     `<div class="sub" style="margin-top:6px">${_t('p_zen_hint')}</div>` +
     `</div>` +
     `<label class="mem-label">${_t('p_preset')}</label>` +
@@ -928,13 +994,19 @@ async function renderProviderPane() {
   /* TEK TİKLA MODEL: OpenCode Zen free kurulumu */
   $('#zenOneClick').addEventListener('click', async () => {
     const btn = $('#zenOneClick');
-    const old = btn.textContent;
+    const label = btn.querySelector('.zen-label');
+    const spinner = btn.querySelector('.zen-load');
+    const old = label.textContent;
     btn.disabled = true;
-    btn.textContent = _t('p_zen_busy');
+    btn.classList.add('loading');
+    spinner.hidden = false;
+    label.textContent = _t('p_zen_busy');
     let r;
     try { r = await beast.zenOneClick(); } catch (e) { r = { ok: false, error: String((e && e.message) || e) }; }
     btn.disabled = false;
-    btn.textContent = old;
+    btn.classList.remove('loading');
+    spinner.hidden = true;
+    label.textContent = old;
     if (r && r.ok) {
       let msg = _ti('p_zen_ok', (r.models || []).length) + ' (OpenCode Zen)';
       if (r.failed && r.failed.length) msg += ' — ' + _ti('p_zen_skipped', r.failed.length);
@@ -1414,6 +1486,35 @@ async function renderIntegrationsPane() {
         <button id="waAllowAdd" class="btn ghost" style="margin-top:6px">${_t('it_add')}</button>
       </div>
       <div class="sub" style="margin-top:8px">${_t('it_allow_note')}</div>
+    </div>
+
+    <div class="wa-card" style="margin-top:14px">
+      <div class="wa-head">
+        <div class="wa-logo tg">T</div>
+        <div>
+          <div class="wa-title">Telegram</div>
+          <div class="wa-sub">${_t('it_tg_sub')}</div>
+        </div>
+      </div>
+      <div class="wa-status"><span id="tgDot" class="wa-dot"></span><span id="tgStatText">—</span></div>
+      <div id="tgUser" class="wa-user" hidden></div>
+      <div class="form-grid" style="grid-template-columns:1fr auto;align-items:center">
+        <input id="tgTokenInp" class="inp" type="password" style="margin:6px 0 0" placeholder="${_t('it_tg_token_ph')}" autocomplete="off" />
+        <button id="tgSaveBtn" class="btn" style="margin-top:6px">${_t('it_tg_save')}</button>
+      </div>
+      <div class="wa-actions" style="margin-top:6px">
+        <button id="tgStopBtn" class="btn ghost">${_t('it_disconnect')}</button>
+      </div>
+      <div class="divider"></div>
+      <label class="mem-label" style="margin-top:0">${_t('it_allow_label')} — Telegram</label>
+      <div id="tgAllowChips" class="chips-inline"></div>
+      <div class="form-grid" style="grid-template-columns:1.2fr 1fr 1fr auto;align-items:center">
+        <input id="tgAllowNameInp" class="inp" style="margin:6px 0 0" placeholder="${_t('it_name_ph')}" autocomplete="off" />
+        <input id="tgAllowIdInp" class="inp" style="margin:6px 0 0" placeholder="${_t('it_tg_id_ph')}" autocomplete="off" />
+        <select id="tgAllowBotSel" class="perm-select" style="margin:6px 0 0;min-width:105px" title="${_t('bot_bind_title')}"></select>
+        <button id="tgAllowAdd" class="btn ghost" style="margin-top:6px">${_t('it_add')}</button>
+      </div>
+      <div class="sub" style="margin-top:8px">${_t('it_tg_note')}</div>
     </div>`;
 
   const waGroupsOn = $('#waGroupsOn');
@@ -1453,6 +1554,29 @@ async function renderIntegrationsPane() {
   waUI.status = snap.status || 'disconnected';
   if (snap.user) waUI.user = snap.user;
   updateWaPane();
+
+  /* TELEGRAM (FEATURE 3): token + allow list + durum */
+  $('#tgSaveBtn').addEventListener('click', async () => {
+    const tok = $('#tgTokenInp').value.trim();
+    if (!tok) { toast(_t('it_tg_token_ph')); return; }
+    toast(_t('it_tg_connecting'));
+    const r = await beast.tgSetToken(tok).catch((e) => ({ status: 'error', error: String(e) }));
+    $('#tgTokenInp').value = '';
+    updateTgPane();
+    toast(r.status === 'connected' ? 'Telegram bağlı: ' + (r.user || '') : r.status === 'error' ? _t('it_tg_token_bad') : _t('it_tg_connecting'));
+  });
+  $('#tgStopBtn').addEventListener('click', async () => {
+    await beast.tgStop().catch(() => {});
+    updateTgPane();
+    toast('Kesildi');
+  });
+  await renderTgAllow();
+  try {
+    const ts = await beast.tgGetStatus();
+    tgUI.status = ts.status || 'disconnected';
+    tgUI.user = ts.user || null;
+    updateTgPane();
+  } catch {}
 }
 
 /* ---------------- Olay Merkezi (ayrı sekme) ---------------- */
@@ -2086,6 +2210,172 @@ function updateWaPane() {
   u.textContent = waUI.user ? '👤 ' + waUI.user : '';
 }
 
+/* ---------------- integrations (Telegram — FEATURE 3) ---------------- */
+
+const tgUI = { status: 'disconnected', user: null };
+const TG_STATUS_TEXT = {
+  disconnected: 'Bağlı değil',
+  connecting: 'Bağlanıyor…',
+  connected: 'Bağlı',
+  error: 'Hata — tokenı kontrol et',
+};
+
+function onTgEvent(ev) {
+  if (ev.type !== 'status') return;
+  tgUI.status = ev.status;
+  if (ev.user) tgUI.user = ev.user;
+  updateTgPane();
+}
+
+function updateTgPane() {
+  const pane = $('#tab-integrations');
+  const dot = pane && pane.querySelector('#tgDot');
+  if (!dot) return;
+  dot.className = 'wa-dot' + (tgUI.status === 'connected' ? ' on' : tgUI.status === 'error' ? ' qr' : '');
+  pane.querySelector('#tgStatText').textContent = TG_STATUS_TEXT[tgUI.status] || tgUI.status;
+  const u = pane.querySelector('#tgUser');
+  u.hidden = !(tgUI.status === 'connected' && tgUI.user);
+  u.textContent = tgUI.user ? '🤖 ' + tgUI.user : '';
+}
+
+/* Telegram izin listesi — WA ile aynı mantık: isim zorunlu, kişi bazlı izin,
+   bot eşleme. Chip × ile silinir; düzenlemek için silip yeniden ekle. */
+async function renderTgAllow() {
+  const wrap = $('#tgAllowChips');
+  if (!wrap) return;
+  const list = await beast.tgGetAllow();
+  let botChoices = [];
+  try { botChoices = (await beast.botsList()) || []; } catch {}
+  const multiBot = botChoices.length >= 2;
+  const tgLabel = (e) => {
+    if (e === '*') return '* herkes';
+    if (typeof e === 'string') return e;
+    const name = String((e && e.name) || '').trim();
+    const id = String((e && e.id) || '');
+    return (name ? name + ' ' : '') + id;
+  };
+  wrap.innerHTML = '';
+  if (!list.length) wrap.innerHTML = '<span class="sub">— boş —</span>';
+  list.forEach((entry, idx) => {
+    const curPerm = (typeof entry === 'object' && entry.perm) || (entry && entry.lockdown ? 'chat' : 'all');
+    const c = document.createElement('span');
+    c.className = 'chip';
+    c.style.margin = '0 6px 6px 0';
+    const txt = document.createElement('span');
+    txt.className = 'chip-txt';
+    txt.textContent = tgLabel(entry);
+    c.appendChild(txt);
+    if (entry !== '*') {
+      /* kişi bazlı granül izin: serbest/web/okuma/kısıtlı (WA ile aynı) */
+      const selP = document.createElement('select');
+      selP.className = 'perm-select';
+      selP.title = _t('wa_perm_title');
+      const PERMS = [
+        ['all', _t('wa_perm_all')],
+        ['web', 'web'],
+        ['read', _t('wa_perm_read')],
+        ['chat', _t('wa_perm_chat')],
+      ];
+      for (const [v, lbl] of PERMS) {
+        const o = document.createElement('option');
+        o.value = v;
+        o.textContent = lbl;
+        if (curPerm === v) o.selected = true;
+        selP.appendChild(o);
+      }
+      selP.addEventListener('change', async () => {
+        const cur = await beast.tgGetAllow();
+        const next = cur.map((e, i) => {
+          if (i !== idx) return e;
+          const base = typeof e === 'string' ? { id: e, name: '' } : { ...e };
+          base.lockdown = selP.value === 'chat';
+          base.perm = selP.value;
+          return base;
+        });
+        await beast.tgSetAllow(next);
+        renderTgAllow();
+        toast(tgLabel(entry) + ': ' + selP.selectedOptions[0].textContent);
+      });
+      c.appendChild(selP);
+
+      /* BOT SİSTEMİ: 2+ bot varsa kaydı hangi botun karşılayacağını seç */
+      if (multiBot) {
+        const sel = document.createElement('select');
+        sel.className = 'perm-select';
+        sel.title = _t('bot_bind_title');
+        for (const bb of botChoices) {
+          const o = document.createElement('option');
+          o.value = bb.id;
+          o.textContent = `${bb.icon} ${bb.name}`;
+          if ((typeof entry === 'object' && entry.bot_id) === bb.id) o.selected = true;
+          sel.appendChild(o);
+        }
+        sel.addEventListener('change', async () => {
+          const cur = await beast.tgGetAllow();
+          const next = cur.map((e, i) => {
+            if (i !== idx) return e;
+            const base = typeof e === 'string' ? { id: e, name: '' } : { ...e };
+            base.bot_id = sel.value || undefined;
+            return base;
+          });
+          await beast.tgSetAllow(next);
+          renderTgAllow();
+          const bt = botChoices.find((bb) => bb.id === sel.value);
+          toast(tgLabel(entry) + ' → ' + (bt ? bt.name : '?'));
+        });
+        c.appendChild(sel);
+      }
+    }
+    const x = document.createElement('span');
+    x.className = 'x';
+    x.textContent = '×';
+    x.addEventListener('click', async () => {
+      const next = (await beast.tgGetAllow()).filter((_v, i) => i !== idx);
+      await beast.tgSetAllow(next);
+      renderTgAllow();
+      toast('Kaldırıldı: ' + tgLabel(entry));
+    });
+    c.appendChild(x);
+    wrap.appendChild(c);
+  });
+
+  /* ekleme formu: isim + (ID veya @username) + bot seçici */
+  const inp = $('#tgAllowIdInp');
+  const nameInp = $('#tgAllowNameInp');
+  const add = $('#tgAllowAdd');
+  const botSel = $('#tgAllowBotSel');
+  if (botSel) {
+    const prev = botSel.value;
+    botSel.innerHTML =
+      `<option value="">${_t('bot_sel_empty')}</option>` +
+      botChoices
+        .map((bb) => `<option value="${bb.id}">${bb.icon} ${escapeHtml(bb.name)}${bb.admin ? ' (admin)' : ''}</option>`)
+        .join('');
+    if (prev) botSel.value = prev;
+  }
+  if (!add.dataset.bound) {
+    add.dataset.bound = '1';
+    const addEntry = async () => {
+      let v = inp.value.trim();
+      if (!v) return;
+      const name = nameInp.value.trim().slice(0, 40);
+      if (!name) { toast('İsim zorunlu — kimin yazdığını bilmek için'); nameInp.focus(); return; }
+      /* @username olduğu gibi; sayısal ID'den boşluk/nokta temizle */
+      v = v.startsWith('@') ? '@' + v.slice(1).replace(/[^\w]/g, '') : v.replace(/[^\d]/g, '');
+      if (!v) { toast(_t('it_tg_id_ph')); return; }
+      const botId = botSel && botSel.value ? { bot_id: botSel.value } : {};
+      await beast.tgSetAllow([...(await beast.tgGetAllow()), { id: v, name, ...botId }]);
+      inp.value = '';
+      nameInp.value = '';
+      renderTgAllow();
+      toast('Eklendi: ' + name);
+    };
+    add.addEventListener('click', addEntry);
+    inp.addEventListener('keydown', (e) => { if (e.key === 'Enter') { e.preventDefault(); addEntry(); } });
+    nameInp.addEventListener('keydown', (e) => { if (e.key === 'Enter') { e.preventDefault(); addEntry(); } });
+  }
+}
+
 /* ---------------- BOT SİSTEMİ (BÖLÜM 2-3-4) ----------------
    Sol panel altında bot kartları; her bot için sohbet geçmişi + sekmeli yönetim.
    İlk bot hep Beast (admin, silinemez). Max 5 bot. */
@@ -2118,6 +2408,9 @@ async function refreshBots() {
   } catch { botsCache = []; }
   try { botPageStats = (await beast.botsStats()) || []; } catch { botPageStats = []; }
   renderBotCards();
+  /* BOT PICKER SENKRONU: liste her yenilendiğinde üstteki rozet de aktif bota
+     ayarlanır — startup yarışında (liste boşken çizilen) eski rozet düzelir */
+  updateBotChip();
   if (!$('#botOverlay').hidden) renderBotPage();
 }
 
@@ -2160,11 +2453,20 @@ async function switchBot(id) {
   const b = botsCache.find((x) => x.id === id);
   if (!b) return;
   if (id === activeBotId) return;
+  /* UI hemen dönsün: rozet + kartlar IPC beklemeden aktif bota geçer */
   activeBotId = id;
-  try { await beast.botsActivate(id); } catch {}
-  try { localStorage.setItem('beast.activeBot', id); } catch {}
   updateBotChip();
   renderBotCards();
+  try {
+    const r = await beast.botsActivate(id);
+    /* main'inkiyle eşleş: normalizasyon ('beast' fallback) varsa düzelt */
+    if (r && r.activeBotId && r.activeBotId !== activeBotId) {
+      activeBotId = r.activeBotId;
+      updateBotChip();
+      renderBotCards();
+    }
+  } catch {}
+  try { localStorage.setItem('beast.activeBot', id); } catch {}
   /* o botun en son oturumuna geç; hiç yoksa o bot için yeni sohbet aç */
   try {
     const list = (await beast.listSessions()).filter((s) => (s.botId || 'beast') === id);
@@ -2898,6 +3200,8 @@ function onEvent(ev) {
     scheduleAgentsRender();
     return;
   }
+  /* OFFLINE MESAJ KUYRUĞU: bağlantı + kuyruk olayları (sessionId filtresinden önce) */
+  if (ev.type === 'net' || ev.type === 'netQueue') { onNetEvent(ev); return; }
   /* Beast Code oturumu (IDE modu ortasındaki panel): olayları panele akıt,
      ana sohbeti kirletme */
   if (bcSessionId && ev.sessionId === bcSessionId) {
@@ -3826,6 +4130,7 @@ async function init() {
   }
 
   beast.onWaEvent(onWaEvent);
+  beast.onTgEvent(onTgEvent);
 
   els.gearBtn.addEventListener('click', openSettings);
   els.setClose.addEventListener('click', closeSettings);

package/src/renderer/style.css

@@ -603,6 +603,7 @@ body.term-open #settingsOverlay { right: var(--tw, 520px); }
   display: flex; align-items: center; justify-content: center;
   font-weight: 900; font-size: 17px;
 }
+.wa-logo.tg { background: #229ED9; }
 .wa-title { font-weight: 800; font-size: 14.5px; }
 .wa-sub { color: var(--muted); font-size: 12px; }
 .wa-status { display: inline-flex; align-items: center; gap: 7px; font-size: 12.5px; margin: 10px 0; }
@@ -720,6 +721,20 @@ body.term-open #settingsOverlay { right: var(--tw, 520px); }
 }
 .msg-assistant .who { color: var(--accent); }
 
+/* offline kuyruk: ⏳ bekleyen mesaj balonu etiketi */
+.msg-user .q-badge {
+  display: inline-block;
+  margin-top: 7px;
+  font-size: 10.5px;
+  font-weight: 700;
+  letter-spacing: 0.3px;
+  color: var(--muted);
+  background: var(--panel);
+  border: 1px dashed var(--border);
+  border-radius: 6px;
+  padding: 2px 8px;
+}
+
 .msg-error {
   border: 1px solid rgba(19, 19, 21, 0.3);
   background: rgba(19, 19, 21, 0.05);
@@ -1736,6 +1751,19 @@ body.browser-open #toast { left: calc((100vw - var(--bw, 480px)) / 2); }
   background: var(--panel);
 }
 .zen-hero .btn { min-width: 220px; }
+.zen-hero .btn .zen-load {
+  display: inline-block;
+  width: 13px;
+  height: 13px;
+  margin-right: 7px;
+  vertical-align: -2px;
+  border: 2px solid rgba(255, 255, 255, 0.35);
+  border-top-color: currentColor;
+  border-radius: 50%;
+  animation: beast-spin 0.8s linear infinite;
+}
+.zen-hero .btn .zen-load[hidden] { display: none; }
+.zen-hero .btn.loading { opacity: 0.75; pointer-events: none; }
 
 /* bot sayfası overlay */
 #botOverlay {