natureco-cli 5.30.0 → 5.32.0

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 All notable changes to NatureCo CLI will be documented in this file.
 
+## [5.32.0] - 2026-07-04 — "AĞAÇ-HAFIZA + OTURUMLAR ARASI KALICILIK (Theseus mimarisi)"
+
+### ✨ Yeni (Hafıza)
+- **Oturumlar arası hafiza DUZELDI**: eski persist dar regex kaliplariyla (sadece "adim X") fact cikariyordu; keyfi bilgi ("parolam X, hatirla") kayboluyordu. Artik ajan `memory_write` ile ANINDA kaydeder → yeni oturumda hatirlanir (E2E: parola S1→S2 ✓).
+- **Agac-hafiza (`memory_tree`)**: kullanicinin OpenCode/Theseus icin tasarladigi tree-memory mimarisinden uyarlandi. Kok (1-kisisel/2-teknik/3-kararlar) → dal (## baslik) → yaprak. action: index|read|search|append. Duz `facts[]` listesinin "coplুğe donme" sorununu cozer; kategorize + logaritmik erisim.
+- **Proaktif yukleme (Theseus deseni)**: her istekte hafiza agaci sistem prompt'una otomatik enjekte edilir ("BILDIGIN KALICI HAFIZA") → ajan on-demand aramaya guvenmeden baglami ZATEN bilir. (E2E: "NatureCoPixel neyle yapiliyor?"→"Godot" ✓; hafiza ile dosya sistemini ayirt eder.)
+- Tek-primary + "bkz:" capraz referans; credential/secret asla duz metin.
+
+Doğrulama: memory_write + memory_tree E2E (S1 kaydet → S2 yeni oturum hatirla); 6 yeni tree testi; **498 test yeşil**, ESLint temiz.
+
+## [5.31.0] - 2026-07-04 — "CHAT/CODE ARAYÜZ ZENGİNLEŞTİRME (araç görünürlüğü + düşünme + input alanı)"
+
+### ✨ Yeni (UX)
+- **Araç görünürlugu**: agentic akista her arac ekranda gorunur — "🔧 <etiket> · <ozet> ✓/✗" (write_file/edit_file/bash/browser/mac_app_open...). Onceden streaming tool XML'ini gizlerken arac aktivitesi de gorunmuyordu; artik gorunur.
+- **Düsünme gostergesi**: model yanit uretirken "💭 düşünüyor…", ilk token gelince temizlenir.
+- **Gorunur input alani**: REPL prompt'u "💬 Sen ▸" + her girdiden once ince ayirici cizgi (cikti/girdi net ayrilir; readline tek-satir → satir duzenleme bozulmaz).
+- **Gorunur acma yonlendirmesi (full mod)**: "kendi tarayicimda ac / dinlemek istiyorum" → headless `browser` yerine gorunur `open`/`start`/`mac_app_open` kullanilir.
+
+Doğrulama: streaming UI E2E (💭 + 🔧 + ✓ gorunuyor); REPL regresyon; **492 test yeşil**.
+
 ## [5.30.0] - 2026-07-04 — "TAM KONTROL MODU (sahip opt-in: tüm araç+skill + computer-use)"
 
 ### ✨ Yeni

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "natureco-cli",
-  "version": "5.30.0",
+  "version": "5.32.0",
   "description": "OpenClaw'dan daha güvenli, daha hızlı, daha ucuz AI agent CLI. Multi-agent, self-evolving skills, audit log, maliyet optimizasyonu ve NatureCo platform-native.",
   "bin": {
     "natureco": "bin/natureco.js"

package/src/commands/repl.js

@@ -1178,14 +1178,20 @@ async function startRepl(args) {
   const rl = readline.createInterface({
     input: createPasteSafeInput(process.stdin),
     output: createOutputFilter(process.stdout),
-    prompt: tui.styled('\n  You  ', { color: tui.PALETTE.primary, bold: true }),
+    prompt: tui.styled('  💬 Sen ▸ ', { color: tui.PALETTE.primary, bold: true }),
     terminal: true,
   });
   // Pipe/script kullanımında EOF, yanıt hâlâ üretilirken gelir —
   // aktif işlem varken kapanışı bekletmek için sayaç + kapalı-rl koruması
   let _busy = 0;
   let _rlClosed = false;
-  const safePrompt = () => { if (!_rlClosed) rl.prompt(); };
+  // Görünür input alanı: her prompttan önce ince ayırıcı çizgi (readline prompt'u tek-satır
+  // kalir → satir duzenleme/gecmis bozulmaz). Cikti ile girdi arasini net ayirir.
+  const safePrompt = () => {
+    if (_rlClosed) return;
+    try { process.stdout.write(tui.styled('\n  ' + '─'.repeat(54) + '\n', { color: tui.PALETTE.muted })); } catch {}
+    rl.prompt();
+  };
   safePrompt();
 
   const cleanup = async (exitCode = 0) => {
@@ -1465,7 +1471,7 @@ async function startRepl(args) {
 
     // Çok satırlı (paste) mesajları gönderildikten sonra ekranda göster
     if (line.indexOf('\n') !== -1) {
-      process.stdout.write(tui.styled('  You  ', { color: tui.PALETTE.primary, bold: true }));
+      process.stdout.write(tui.styled('  💬 Sen ▸ ', { color: tui.PALETTE.primary, bold: true }));
       process.stdout.write(line + '\n');
     }
 

package/src/tools/agentic-runner.js

@@ -21,7 +21,7 @@ const os = require('os');
 // icinde approvals politikasini uyguluyor (isSafeCommand → direkt; tehlikeli → red;
 // digerleri → allowlist/full moda gore). Yani keyfi/yikici komut calismaz.
 // Diger ~85 arac (discord, telegram, cron, browser...) bilerek DISARIDA.
-const DEFAULT_ALLOWED = ['write_file', 'read_file', 'edit_file', 'skill_view', 'bash', 'file_search', 'list_dir'];
+const DEFAULT_ALLOWED = ['write_file', 'read_file', 'edit_file', 'skill_view', 'bash', 'file_search', 'list_dir', 'memory_write', 'memory_tree'];
 
 const TOOL_ALIASES = {
   write_file: 'write_file', create_file: 'write_file', writefile: 'write_file', write: 'write_file', create: 'write_file', save_file: 'write_file', new_file: 'write_file',
@@ -31,6 +31,8 @@ const TOOL_ALIASES = {
   bash: 'bash', run_command: 'bash', shell: 'bash', shell_command: 'bash', exec: 'bash', run_terminal: 'bash', terminal: 'bash', run: 'bash', command: 'bash',
   file_search: 'file_search', glob: 'file_search', find_files: 'file_search', search_files: 'file_search', find: 'file_search',
   list_dir: 'list_dir', ls: 'list_dir', dir: 'list_dir', list_directory: 'list_dir', filesystem: 'list_dir',
+  memory_write: 'memory_write', remember: 'memory_write', save_memory: 'memory_write', memorize: 'memory_write', memory_save: 'memory_write', save_fact: 'memory_write',
+  memory_tree: 'memory_tree', tree_memory: 'memory_tree', memory: 'memory_tree', hafiza: 'memory_tree',
 };
 
 function expandHome(p) {
@@ -326,7 +328,7 @@ async function executeCall(call, opts = {}) {
  * callModel(messages) => Promise<{ content, toolCalls }>
  * Donus: { records, reply, iterations }
  */
-async function runAgentic({ callModel, systemPrompt, historyMessages, task, toolsDir, loadTool, allowed, execFull, maxIterations = 15 }) {
+async function runAgentic({ callModel, systemPrompt, historyMessages, task, toolsDir, loadTool, allowed, execFull, onEvent, maxIterations = 15 }) {
   const messages = [{ role: 'system', content: systemPrompt }];
   for (const mm of historyMessages || []) messages.push({ role: mm.role, content: mm.content || '' });
   messages.push({ role: 'user', content: task });
@@ -349,7 +351,9 @@ async function runAgentic({ callModel, systemPrompt, historyMessages, task, tool
     messages.push({ role: 'assistant', content: content || '' });
     const feedbacks = [];
     for (const call of calls) {
+      if (onEvent) { try { onEvent({ phase: 'start', tool: call.tool, args: call.args }); } catch {} }
       const { records, feedback } = await executeCall(call, { toolsDir, loadTool, allowed: allowedSet, execFull });
+      if (onEvent) { try { onEvent({ phase: 'end', tool: call.tool, args: call.args, records }); } catch {} }
       allRecords.push(...records);
       feedbacks.push(feedback);
     }

package/src/tools/memory_tree.js

@@ -0,0 +1,156 @@
+/**
+ * memory_tree — Ağaç-hafıza (kök → dal → yaprak). Kullanıcının OpenCode için tasarladığı
+ * tree-memory mimarisinden uyarlandı (opencode-hafiza-mimarisi.md).
+ *
+ * Felsefe: "bilgi saklama" değil "hızlı bilgi bulma". Düz liste zamanla çöplüğe döner;
+ * ağaç logaritmik arama sağlar (kök seç → dal seç → yaprak oku, <300 token).
+ *
+ * Yapı: ~/.natureco/memory/tree/<user>/
+ *   0-index.md   — yönlendirme (hangi konu hangi kökte)
+ *   1-kisisel.md — Kişisel & Tercihler (## dallar altında yapraklar)
+ *   2-teknik.md  — Teknik & Projeler
+ *   3-kararlar.md— Kararlar, Kurallar & Dersler
+ *
+ * Kurallar (mimariden): tek primary + "bkz:" çapraz referans; yeni bilgi ilgili dalın
+ * altına (dosya sonuna değil); credential/secret ASLA düz metin ("bkz: secrets vault").
+ */
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const ROOTS = [
+  { id: '1-kisisel', title: 'Kişisel & Tercihler', branches: ['Kimlik', 'Tercihler', 'İletişim Kalıpları'] },
+  { id: '2-teknik', title: 'Teknik & Projeler', branches: ['Projeler', 'Kurulum & Sistem', 'Teknik Referans'] },
+  { id: '3-kararlar', title: 'Kararlar, Kurallar & Dersler', branches: ['Kararlar', 'Kurallar & Kısıtlar', 'Öğrenilen Dersler', 'Tarihli Olaylar'] },
+];
+
+function treeDir(username) {
+  return path.join(os.homedir(), '.natureco', 'memory', 'tree', String(username || 'default').toLowerCase());
+}
+function rootPath(username, id) { return path.join(treeDir(username), id + '.md'); }
+function readSafe(username, id) { try { return fs.readFileSync(rootPath(username, id), 'utf8'); } catch { return ''; } }
+function resolveRoot(root) {
+  if (!root) return ROOTS[0];
+  const r = String(root).toLowerCase();
+  return ROOTS.find((x) => x.id === r || x.id.endsWith(r.replace(/^\d+-/, '')) || x.id.includes(r) || x.title.toLowerCase().includes(r)) || ROOTS[0];
+}
+
+function ensureTree(username) {
+  const dir = treeDir(username);
+  fs.mkdirSync(dir, { recursive: true });
+  for (const r of ROOTS) {
+    const p = rootPath(username, r.id);
+    if (!fs.existsSync(p)) fs.writeFileSync(p, `# ${r.title}\n\n` + r.branches.map((b) => `## ${b}\n`).join('\n'), 'utf8');
+  }
+  const idx = path.join(dir, '0-index.md');
+  if (!fs.existsSync(idx)) fs.writeFileSync(idx, '# Hafıza İndeksi (kök → dal)\n\n' + ROOTS.map((r) => `- **${r.id}** — ${r.title}: ${r.branches.join(', ')}`).join('\n') + '\n', 'utf8');
+}
+
+// Modele enjekte edilen kompakt indeks (dal başlıkları + yaprak sayısı).
+function buildIndex(username) {
+  ensureTree(username);
+  const lines = [];
+  for (const r of ROOTS) {
+    const txt = readSafe(username, r.id);
+    const branches = (txt.match(/^##\s+(.+)$/gm) || []).map((s) => s.replace(/^##\s+/, '').trim());
+    const leaves = (txt.match(/^\s*-\s+\S/gm) || []).length;
+    lines.push(`- ${r.id} (${r.title}) — dallar: ${branches.join(' · ') || '(boş)'}${leaves ? ` [${leaves} kayıt]` : ''}`);
+  }
+  return lines.join('\n');
+}
+
+function readRoot(username, id) {
+  ensureTree(username);
+  try { return fs.readFileSync(rootPath(username, resolveRoot(id).id), 'utf8'); } catch { return ''; }
+}
+
+// Theseus deseni: oturum BAŞINDA hafızayı proaktif yükle. Tüm kökler-dallar-yapraklardan
+// (boş dallar hariç) kompakt bir özet çıkar → sistem prompt'una gömülür ki ajan
+// on-demand aramaya güvenmeden bilgiyi ZATEN bilsin. maxChars aşılırsa kırpılır.
+function buildDigest(username, maxChars = 2600) {
+  ensureTree(username);
+  const parts = [];
+  for (const r of ROOTS) {
+    const txt = readSafe(username, r.id);
+    let branch = '';
+    const byBranch = {};
+    for (const line of txt.split('\n')) {
+      if (line.startsWith('## ')) branch = line.slice(3).trim();
+      else if (/^\s*-\s+\S/.test(line)) (byBranch[branch] = byBranch[branch] || []).push(line.trim().replace(/^-\s*/, ''));
+    }
+    const nonEmpty = Object.entries(byBranch).filter(([, l]) => l.length);
+    if (nonEmpty.length) {
+      parts.push(`[${r.title}]`);
+      for (const [b, l] of nonEmpty) parts.push(`  ${b}: ${l.join('; ')}`);
+    }
+  }
+  let out = parts.join('\n');
+  if (out.length > maxChars) out = out.slice(0, maxChars) + '\n…(fazlası için memory_tree ile oku)';
+  return out;
+}
+
+function search(username, query) {
+  ensureTree(username);
+  const q = String(query || '').toLowerCase().trim();
+  if (!q) return [];
+  const hits = [];
+  for (const r of ROOTS) {
+    const txt = readSafe(username, r.id);
+    let branch = '';
+    for (const line of txt.split('\n')) {
+      if (line.startsWith('## ')) branch = line.slice(3).trim();
+      else if (line.trim() && !line.startsWith('#') && line.toLowerCase().includes(q)) hits.push(`${r.id}/${branch}: ${line.trim()}`);
+    }
+  }
+  return hits;
+}
+
+function append(username, root, branch, content) {
+  ensureTree(username);
+  const r = resolveRoot(root);
+  const p = rootPath(username, r.id);
+  const br = String(branch || 'Genel').trim();
+  const leaf = '- ' + String(content).replace(/\s+/g, ' ').trim();
+  let txt = fs.readFileSync(p, 'utf8');
+  const bRe = new RegExp(`^##[ \\t]+${br.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[ \\t]*$`, 'mi');
+  const m = txt.match(bRe);
+  if (m) {
+    const idx = txt.indexOf(m[0]) + m[0].length;
+    txt = txt.slice(0, idx) + '\n' + leaf + txt.slice(idx);
+  } else {
+    txt = txt.trimEnd() + `\n\n## ${br}\n${leaf}\n`;
+  }
+  fs.writeFileSync(p, txt, 'utf8');
+  return { success: true, root: r.id, branch: br, saved: leaf };
+}
+
+module.exports = {
+  name: 'memory_tree',
+  description: 'Ağaç-hafıza (kök→dal→yaprak): kalıcı bilgiyi kategorize SAKLA/OKU/ARA. Yeni oturumda hatırlanır. action: index|read|search|append',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      action: { type: 'string', description: 'index | read | search | append' },
+      username: { type: 'string', description: 'kullanıcı adı' },
+      root: { type: 'string', description: '1-kisisel | 2-teknik | 3-kararlar' },
+      branch: { type: 'string', description: 'dal başlığı (append için)' },
+      content: { type: 'string', description: 'yaprak metni (append için)' },
+      query: { type: 'string', description: 'arama (search için)' },
+    },
+    required: ['action'],
+  },
+  async execute(p) {
+    const u = p.username || 'default';
+    try {
+      if (p.action === 'index') return { success: true, index: buildIndex(u) };
+      if (p.action === 'read') return { success: true, content: readRoot(u, p.root || '1-kisisel') };
+      if (p.action === 'search') return { success: true, results: search(u, p.query || p.content || '') };
+      if (p.action === 'append') {
+        if (!p.content) return { success: false, error: 'content (yaprak metni) gerekli' };
+        return append(u, p.root || '1-kisisel', p.branch || 'Genel', p.content);
+      }
+      return { success: false, error: 'bilinmeyen action: ' + p.action + ' (index|read|search|append)' };
+    } catch (e) { return { success: false, error: e.message }; }
+  },
+  _internal: { ensureTree, buildIndex, buildDigest, readRoot, search, append, treeDir, rootPath, ROOTS },
+};

package/src/tools/workflow.js

@@ -222,6 +222,11 @@ async function workflow(params) {
       const { runAgentic } = require('./agentic-runner');
       const memCtx = memoryContext();
       const desktop = path.join(os.homedir(), 'Desktop');
+      const memUser = cfg.userName || 'default';
+      // Theseus deseni: oturum basinda hafiza agacini PROAKTIF yukle (on-demand aramaya
+      // guvenme). Digest = kayitli bilgiler (icerik); Index = yapi (kok→dal).
+      let treeIndex = '', treeDigest = '';
+      try { const mt = require('./memory_tree')._internal; treeDigest = mt.buildDigest(memUser); treeIndex = mt.buildIndex(memUser); } catch {}
       // Tam mod (sahibin opt-in'i): tum arac+skill'ler acilir, keyfi shell (yikici haric).
       const execFull = cfg.agentExec === 'full' || cfg.computerUse === true || String(process.env.NATURECO_AGENT_EXEC || '').toLowerCase() === 'full';
       let fullToolsBlock = '';
@@ -231,11 +236,11 @@ async function workflow(params) {
           '\n\nTAM MOD ACIK — su araclara da ERISIMIN VAR; o an ne gerekiyorsa dogrudan cagir:',
           '- mac_app_open: macOS uygulamasi ac. parametre: appName (orn. "WhatsApp", "Google Chrome", "Spotify")',
           '- mac_app_quit: macOS uygulamasi kapat. parametre: appName',
-          '- browser: tarayici otomasyonu (Playwright). parametreler: action ("open"/"screenshot"/"html"/"evaluate"), url, script',
+          '- browser: HEADLESS tarayici otomasyonu (icerik cek/screenshot — kullaniciya GORUNMEZ). parametreler: action, url, script',
           '- computer_use: GUI otomasyonu. parametreler: action ("screenshot"/"click"/"type"/"keypress"/"scroll"), x, y, text, key',
           '- social_open: muzik/video/sosyal ac. parametreler: query, platform (spotify/youtube...)',
           '- macos_screenshot: ekran goruntusu al',
-          '- bash ile de acabilirsin: "open -a WhatsApp", "open https://...", "start chrome https://..."',
+          '\nGORUNUR ACMA (onemli): Kullanici "kendi tarayicimda ac / gorunur ac / dinlemek/izlemek istiyorum" derse `browser` (headless, gorunmez) DEGIL, GORUNUR ac: macOS bash ile `open "https://..."` ya da `open -a "Google Chrome" "https://..."`; Windows `start "" "https://..."`. Uygulama icin `open -a WhatsApp` / mac_app_open. Muzik/video icin dogrudan YouTube/Spotify URL\'sini `open` ile ac.',
           '\nTum arac listesi (isimle cagir; parametre yanlissa <tool_results> duzeltir): ' + allNames.join(', '),
         ].join('\n');
       }
@@ -252,7 +257,11 @@ async function workflow(params) {
         '- list_dir: dizin icerigini listele. parametre: path',
         '- bash: kabuk komutu calistir (npm, git, node, python, test, ls, grep/findstr, mkdir...). parametre: command. Guvenli komutlar dogrudan calisir; yikici/tehlikeli komutlar guvenlik politikasiyla engellenir. Icerik aramasi icin grep/findstr kullan.',
         '- skill_view: gorevle ilgili bir skill yukle. parametre: name',
+        '- memory_write: HIZLI tek bilgi kaydet (isim, kisa tercih). parametreler: username ("' + memUser + '"), fact, category. YENI oturumda hatirlanir.',
+        '- memory_tree: AGAC-HAFIZA — zengin/kategorize kalici bilgi (proje, karar, teknik not, kisisel detay). action: index|read|search|append; username="' + memUser + '"; append icin: root (1-kisisel|2-teknik|3-kararlar) + branch (dal basligi) + content (yaprak). YENI oturumda hatirlanir.',
         '\nKurallar:',
+        '- Kullanici kalici bilgi paylasirsa (isim, tercih, parola, proje, karar, onemli detay) ya da "hatirla / not al / kaydet" derse HEMEN KAYDET (username="' + memUser + '"): kisa tek bilgi → memory_write; zengin/kategorize bilgi → memory_tree(append, dogru root/branch). Trivial/gecici seyleri kaydetme.',
+        '- Kullaniciya ozel bir sey sorulunca (gecmis, proje, tercih, karar) once memory_tree(search/read) ile ilgili kok/dali OKU (hedefli, tum hafizayi degil). Tek primary: bilgi tek yerde yasar; digerine sadece "bkz:". Credential/secret ASLA duz metin.',
         '- MEVCUT bir dosyayi degistirmeden ONCE read_file ile oku; sonra edit_file ile hedefli degisiklik yap (tum dosyayi write_file ile ezme).',
         '- Bir seyi nerede oldugunu bilmiyorsan once file_search/list_dir/bash(grep) ile kesfet.',
         '- Kod yazdiktan/degistirdikten sonra gerektiginde bash ile calistir/test et (orn. "node dosya.js", "npm test"); hata cikarsa duzelt.',
@@ -263,6 +272,8 @@ async function workflow(params) {
         '- Basit sohbet/selamlasma ise arac cagirma, dogrudan kisa yanit ver.',
         execFull ? '- Kullanici uygulama ac / tarayici kontrol / muzik cal / ekran / GUI istediyse yukaridaki computer-use araclarini KULLAN — "yapamam/engellendi" DEME, dogrudan ilgili araci cagir.' : '',
         fullToolsBlock,
+        treeDigest ? ('\n\nBILDIGIN KALICI HAFIZA (bu kullaniciya ait, onceki oturumlardan hatirladiklarin; kullaniciya ozel bir sey sorulursa ONCE BUNU KULLAN — dosya arama, uydurma):\n' + treeDigest) : '',
+        treeIndex ? ('\n\nHafiza agaci yapisi (yukarida olmayan detay icin memory_tree(action:read/search) ile ilgili kok/dali oku):\n' + treeIndex) : '',
         skillsIndexBlock ? '\n\n' + skillsIndexBlock : '',
       ].filter(Boolean).join('\n');
 
@@ -279,11 +290,14 @@ async function workflow(params) {
 
       async function callModel(msgs) {
         if (streamOn) {
-          const sani = makeSanitizeStream(botName, t => process.stdout.write(t));
+          let cleared = false;
+          const clearThinking = () => { if (!cleared) { process.stdout.write('\r\x1b[K'); cleared = true; } };
+          process.stdout.write('\x1b[2m  💭 düşünüyor…\x1b[0m');
+          const sani = makeSanitizeStream(botName, t => { clearThinking(); process.stdout.write(t); });
           const filter = makeStreamFilter(t => sani.push(t), null);
           const body = { model, stream: true, messages: msgs, temperature: 0.3, max_tokens: 16000 };
           const out = await apiCallStream(providerUrl, providerApiKey, body, d => filter.push(d));
-          filter.end(); sani.end();
+          filter.end(); sani.end(); clearThinking();
           return { content: out.content || '', toolCalls: out.toolCalls || [] };
         }
         const body = { model, stream: false, messages: msgs, temperature: 0.3, max_tokens: 16000 };
@@ -292,10 +306,28 @@ async function workflow(params) {
         return { content: msg.content || '', toolCalls: msg.tool_calls || [] };
       }
 
+      // Araç aktivitesi gösterimi (TTY streaming): her araç icin "🔧 label · hint ✓/✗"
+      const TOOL_LABEL = { write_file: 'dosya yaz', read_file: 'oku', edit_file: 'düzenle', bash: 'komut', file_search: 'ara', list_dir: 'listele', skill_view: 'skill', browser: 'tarayıcı', browser_use: 'tarayıcı', mac_app_open: 'uygulama aç', mac_app_quit: 'uygulama kapat', computer_use: 'GUI', social_open: 'medya aç', macos_screenshot: 'ekran görüntüsü' };
+      function briefHint(args) {
+        if (!args || typeof args !== 'object') return '';
+        const v = args.appName || args.query || args.name || args.url || args.command || args.pattern || args.path || args.action;
+        return v ? String(v).replace(/\s+/g, ' ').slice(0, 46) : '';
+      }
+      const onEvent = streamOn ? (ev) => {
+        if (ev.phase === 'start') {
+          const label = TOOL_LABEL[ev.tool] || ev.tool;
+          const hint = briefHint(ev.args);
+          process.stdout.write('\n\x1b[2m  🔧 ' + label + (hint ? ' · ' + hint : '') + '\x1b[0m');
+        } else {
+          const rec = (ev.records || [])[0] || {};
+          process.stdout.write(rec.status === 'done' ? ' \x1b[32m✓\x1b[0m' : ' \x1b[31m✗\x1b[0m');
+        }
+      } : null;
+
       try {
         const { records, reply } = await runAgentic({
           callModel, systemPrompt: sysMsg, historyMessages, task,
-          toolsDir: __dirname, execFull, maxIterations: 15,
+          toolsDir: __dirname, execFull, onEvent, maxIterations: 15,
         });
         const fileWrites = records.filter(r => r.tool === 'write_file' && r.status === 'done');
         let finalReply = reply || '';