natureco-cli 5.2.1 → 5.3.1

package/CHANGELOG.md

@@ -537,3 +537,35 @@ Parton'un vizyonu: "Ihtiyaca gore skill yoksa kendi uretsin". LLM ile yeni bir s
 - **Versiyon**: 5.1.0
 - **Kurulum**: `npm install -g natureco-cli`
 - **Lisans**: MIT
+
+## [5.3.0] - 2026-06-22 — "VOICE EDITION + AUTO-MEMORY"
+
+### Yeni: voice_chat Tool (52. Tool)
+Parton'un vizyonu: "Bilgisayarla konusayim".
+- macOS'ta mikrofondan ses kaydi (`rec` + `sox`)
+- Whisper API ile ses → metin donusumu (Turkce)
+- Cevabi macOS `say` ile sesli oku
+- Hands-free agent kullanimi
+
+### Yeni: Otomatik Memory Extractor (REPL'e entegre)
+v5.3.0 ile REPL, kullanicinin kişisel bilgi verdigini anlayip otomatik kaydeder:
+- 'adım X' → memory'ye 'Adı: X' yaz
+- 'sevdiğim X' → preference kategorisinde
+- 'ben X yapıyorum' → work kategorisinde
+- 'X tutkunuyum' → hobby kategorisinde
+- 'sen benim patronumsun' → botName='Patronum' olarak degistir
+- 'adın X olsun' → botName=X olarak kaydet
+
+Bu sayede Parton'un vizyonu gerceklesiyor: "her seferinde hatirlatmayacagim, beni hatirlayacak".
+
+### Bagimlilik Temizligi (v5.2.1)
+- chalk 4 → 5
+- commander 11 → 12
+- pino 8 → 9
+- json5 kaldirildi (transitive dependency)
+- npm audit temizlendi
+
+### Testler (51 → 52 tool)
+- %88 basarili test (Parton'un son test raporu)
+- Tum Phase 1 bug'lari duzeltildi
+- macOS native integration tamamlandi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "natureco-cli",
-  "version": "5.2.1",
+  "version": "5.3.1",
   "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

@@ -468,7 +468,14 @@ async function startRepl(args) {
     // v4.7.4: Daha agresif dil zorlaması — model önceki versiyonlarda İngilizce cevap veriyordu
     'KRİTİK DİL KURALI: Kullanıcı Türkçe yazıyorsa MUTLAKA %100 Türkçe cevap ver. Asla İngilizce, Çince veya başka dil kullanma. Cevabının TAMAMI Türkçe olmalı.',
     'ÖNEMLİ: <tool_call>, <invoke>, function_call veya benzeri XML/JSON formatında tool çağrısı SİMÜLE ETME. Sadece düz metin cevap ver. Bir işlem yapmak gerekirse kullanıcıya nasıl yapılacağını açıkla veya shell komutunu paylaş.',
-    // v5.1.1: Memory'ye otomatik kaydet — kullanici kim olduğunu/neyi sevdiğini söylerse memory_write tool'unu çağır
+    "KRİTİK: Kullanıcı kişisel bilgi verdiğinde MUTLAKA memory_write tool'unu çağır. Kurallar:\n" +
+    "  - 'adım X' → username=cfg.userName, fact='Adı: X', category=personal\n" +
+    "  - 'sevdiğim X' / 'sevmiyorum X' → fact + category=preference\n" +
+    "  - 'ben X yapıyorum' → fact + category=work\n" +
+    "  - 'X tutkunuyum' → fact + category=hobby\n" +
+    "  - 'sen benim patronumsun' → botName='Patronum', category=personal\n" +
+    "  - 'adın X olsun' / 'sana X diyeyim' → botName=X\n" +
+    "  Kullanıcı bilgi verdiyse UNUTMA, memory_write'ı çağır!",
     "ÖNEMLİ: Kullanıcı \"adım X\", \"sevdiğim Y\", \"ben Z\" gibi kişisel bilgi verdiğinde MUTLAKA memory_write tool'unu çağır (username: kullanıcı adı, fact: bilgi, category: personal). Bu sayede sonraki oturumlarda hatırlayabilirsin. \"Sen benim patronumsun\" gibi ifadeler de memory'ye yazılmalı.",
     // v5.1.1: Bot isim değişikliği
     'Kullanıcı "senin adın X" derse memory_write ile botName değiştir ve bundan sonra kendini o isimle tanıt.',

package/src/tools/cross_session_memory.js

@@ -0,0 +1,142 @@
+/**
+ * cross_session_memory - Oturumlar arasi hafiza (v5.3.1)
+ *
+ * Parton'un vizyonu: "Hafta sonra gelince de beni hatirlayacak"
+ *
+ * Ozellikler:
+ *   - Tum session'lari tarihsel sirayla yukler
+ *   - Memory fact'lerini otomatik ekler system prompt'a
+ *   - /resume komutu onceki session'in context'ini getirir
+ *   - Yeni session'da eski bilgilerden haberi olur
+ */
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+const SESSION_DIR = path.join(os.homedir(), ".natureco", "sessions");
+const MEMORY_DIR = path.join(os.homedir(), ".natureco", "memory");
+
+function loadSession(id) {
+  try {
+    const file = path.join(SESSION_DIR, id.endsWith(".json") ? id : id + ".json");
+    if (!fs.existsSync(file)) return null;
+    return JSON.parse(fs.readFileSync(file, "utf8"));
+  } catch {
+    return null;
+  }
+}
+
+function listSessions(limit = 20) {
+  try {
+    if (!fs.existsSync(SESSION_DIR)) return [];
+    return fs.readdirSync(SESSION_DIR)
+      .filter(f => f.endsWith(".json"))
+      .map(f => {
+        try {
+          const stat = fs.statSync(path.join(SESSION_DIR, f));
+          const data = JSON.parse(fs.readFileSync(path.join(SESSION_DIR, f), "utf8"));
+          return {
+            id: f.replace(".json", ""),
+            startedAt: data.startedAt || stat.birthtime.toISOString(),
+            messageCount: (data.messages || []).length,
+            preview: (data.messages || [])
+              .filter(m => m.role === "user")
+              .slice(0, 2)
+              .map(m => typeof m.content === "string" ? m.content.slice(0, 80) : "")
+              .join(" | "),
+          };
+        } catch {
+          return { id: f, error: "parse hatasi" };
+        }
+      })
+      .sort((a, b) => (b.startedAt || "").localeCompare(a.startedAt || ""))
+      .slice(0, limit);
+  } catch {
+    return [];
+  }
+}
+
+function getCrossSessionContext({ username = null, limit = 5, maxTokens = 800 } = {}) {
+  const sessions = listSessions(limit);
+  const contextParts = [];
+
+  // Memory'den de ekle
+  if (username) {
+    const memFile = path.join(MEMORY_DIR, `${username.toLowerCase()}.json`);
+    try {
+      if (fs.existsSync(memFile)) {
+        const mem = JSON.parse(fs.readFileSync(memFile, "utf8"));
+        if (mem.facts && mem.facts.length > 0) {
+          contextParts.push("KULLANICI HAFIZASI:\n" + mem.facts
+            .slice(0, 10)
+            .map(f => `- ${f.value || f}`)
+            .join("\n"));
+        }
+        if (mem.botName) {
+          contextParts.push(`Bot adin: ${mem.botName}`);
+        }
+      }
+    } catch {}
+  }
+
+  // Son N session'dan user message'lari
+  if (sessions.length > 0) {
+    const recentTopics = sessions
+      .map(s => s.preview)
+      .filter(Boolean)
+      .join("\n- ");
+    if (recentTopics) {
+      contextParts.push(`SON KONUŞMALAR:\n- ${recentTopics}`);
+    }
+  }
+
+  const full = contextParts.join("\n\n");
+  // Truncate
+  if (full.length > maxTokens * 4) {
+    return full.slice(0, maxTokens * 4) + "...";
+  }
+  return full;
+}
+
+async function crossSessionMemory({ action = "list", sessionId = null, username = null, contextFor = "system" } = {}) {
+  if (action === "list") {
+    const sessions = listSessions(20);
+    return { success: true, count: sessions.length, sessions };
+  }
+
+  if (action === "load" && sessionId) {
+    const sess = loadSession(sessionId);
+    if (!sess) return { success: false, error: `Session bulunamadi: ${sessionId}` };
+    return { success: true, session: sess };
+  }
+
+  if (action === "context") {
+    const context = getCrossSessionContext({ username });
+    return {
+      success: true,
+      context,
+      sources: username ? ["memory", "sessions"] : ["sessions"],
+      message: "Cross-session context yuklendi",
+    };
+  }
+
+  return { success: false, error: `Bilinmeyen action: ${action}` };
+}
+
+module.exports = {
+  name: "cross_session_memory",
+  description: "Oturumlar arasi hafiza: /resume, listele, memory'den context yukle. Kullanici hafta sonra gelince bile hatirlar.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      action: { type: "string", description: "list/load/context", enum: ["list", "load", "context"] },
+      sessionId: { type: "string", description: "Session ID (load icin)" },
+      username: { type: "string", description: "Kullanici adi (memory filtreleme icin)" },
+    },
+    required: ["action"],
+  },
+  async execute(params) {
+    return await crossSessionMemory(params);
+  },
+};

package/src/tools/plan.js

@@ -0,0 +1,161 @@
+/**
+ * plan - Plan modu (v5.3.1)
+ *
+ * Parton'un vizyonu: "Karmasik isleri once planlasin, sonra calistirayim"
+ *
+ * Ozellikler:
+ *   - Sadece plan yapar, hicbir tool calistirmaz
+ *   - Multi-step gorevler icin adim adim yol haritasi
+ *   - Kullanici plani onayladiktan sonra execute
+ */
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const https = require("https");
+
+const PLAN_DIR = path.join(os.homedir(), ".natureco", "plans");
+
+function loadConfig() {
+  try {
+    return JSON.parse(fs.readFileSync(path.join(os.homedir(), ".natureco", "config.json"), "utf8"));
+  } catch { return {}; }
+}
+
+function isMiniMax(url) {
+  return url && (url.includes("minimax.io") || url.includes("minimaxi.com"));
+}
+
+async function planTask({ task, depth = "detailed" }) {
+  const cfg = loadConfig();
+  if (!cfg.providerUrl || !cfg.providerApiKey) {
+    return { success: false, error: "Provider ayarli degil. Once: natureco setup" };
+  }
+
+  const prompt = `Asagidaki gorev icin ${depth === "minimal" ? "kisa" : "detayli"} bir PLAN olustur. Sadece plan, hicbir islem yapma.
+
+GOREV: ${task}
+
+CIKTI FORMATI (Markdown):
+# Plan: <Gorev Adi>
+
+## Ozet
+[1-2 cumle]
+
+## On Kosullar
+- [...]
+
+## Adimlar
+1. **Adim 1**: <aciklama>
+   - Arac: <tool adi>
+   - Beklenen cikti: <ne elde edecegiz>
+2. **Adim 2**: ...
+
+## Dizinleyici Bilgiler
+- Toplam adim: X
+- Tahmini sure: X dakika
+- Risk: <dusuk/orta/yuksek>
+- Bagimlilik: <hangi dosyalar/klasorler>
+
+Sadece plan yaz, baska bir sey yazma.`;
+
+  const body = {
+    model: cfg.providerModel || "MiniMax-M2.5",
+    messages: [
+      { role: "system", content: "Sen bir planlama asistanisin. Sadece plan yaz, hicbir islem yapma. Turkce yaz." },
+      { role: "user", content: prompt },
+    ],
+    temperature: 0.5,
+    max_tokens: 2000,
+  };
+
+  return new Promise((resolve) => {
+    const isMM = isMiniMax(cfg.providerUrl);
+    const endpoint = isMM
+      ? cfg.providerUrl.replace(/\/+$/, "") + "/v1/text/chatcompletion_v2"
+      : cfg.providerUrl.replace(/\/+$/, "") + "/chat/completions";
+    const data = JSON.stringify(body);
+    const req = https.request(endpoint, {
+      method: "POST",
+      headers: { "Authorization": "Bearer " + cfg.providerApiKey, "Content-Type": "application/json" },
+      timeout: 60000,
+    }, res => {
+      let body = "";
+      res.on("data", c => body += c);
+      res.on("end", () => {
+        if (res.statusCode === 200) {
+          try {
+            const parsed = JSON.parse(body);
+            const planText = parsed.choices?.[0]?.message?.content || "";
+            // Plani kaydet
+            if (!fs.existsSync(PLAN_DIR)) fs.mkdirSync(PLAN_DIR, { recursive: true });
+            const planId = `plan-${Date.now().toString(36)}`;
+            const planFile = path.join(PLAN_DIR, planId + ".md");
+            fs.writeFileSync(planFile, planText, "utf8");
+            resolve({
+              success: true,
+              planId,
+              task,
+              plan: planText,
+              path: planFile,
+              message: `Plan olusturuldu: ${planId}. Onaylarsan 'execute' ile calistir.`,
+            });
+          } catch (e) {
+            resolve({ success: false, error: "Parse hatasi: " + e.message });
+          }
+        } else {
+          resolve({ success: false, error: `HTTP ${res.statusCode}: ${body.slice(0, 200)}` });
+        }
+      });
+    });
+    req.on("error", e => resolve({ success: false, error: e.message }));
+    req.on("timeout", () => req.destroy() && resolve({ success: false, error: "Timeout" }));
+    req.write(data);
+    req.end();
+  });
+}
+
+async function listPlans() {
+  try {
+    if (!fs.existsSync(PLAN_DIR)) return { success: true, count: 0, plans: [] };
+    const files = fs.readdirSync(PLAN_DIR).filter(f => f.endsWith(".md")).sort().reverse().slice(0, 10);
+    const plans = files.map(f => {
+      try {
+        const content = fs.readFileSync(path.join(PLAN_DIR, f), "utf8");
+        const titleMatch = content.match(/^# Plan: (.+)$/m);
+        const stepMatch = content.match(/^(\d+)\. \*\*Adim/m);
+        return {
+          id: f.replace(".md", ""),
+          title: titleMatch ? titleMatch[1] : f,
+          totalSteps: stepMatch ? parseInt(stepMatch[1]) : 0,
+          preview: content.slice(0, 200),
+          path: path.join(PLAN_DIR, f),
+        };
+      } catch {
+        return { id: f, error: "parse hatasi" };
+      }
+    });
+    return { success: true, count: plans.length, plans };
+  } catch (e) {
+    return { success: false, error: e.message };
+  }
+}
+
+module.exports = {
+  name: "plan",
+  description: "Plan modu: karmasik gorevler icin once yol haritasi olusturur, hicbir tool calistirmaz. Kullanici onayladiktan sonra execute.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      action: { type: "string", description: "create (plan olustur) / list (planlari listele)", enum: ["create", "list"] },
+      task: { type: "string", description: "Planlanacak gorev (create icin)" },
+      depth: { type: "string", description: "minimal/detailed (default: detailed)", enum: ["minimal", "detailed"] },
+    },
+    required: ["action"],
+  },
+  async execute(params) {
+    if (params.action === "list") return listPlans();
+    if (!params.task) return { success: false, error: "task gerekli (create icin)" };
+    return await planTask(params);
+  },
+};

package/src/tools/voice_chat.js

@@ -0,0 +1,178 @@
+/**
+ * voice_chat - Sesli asistan (v5.3.0)
+ *
+ * Parton'un vizyonu: "Bilgisayarla konusayim"
+ *
+ * Mikrofon → Whisper STT → REPL'e metin olarak gönder
+ * Bot cevabı → TTS ile sesli oku
+ *
+ * macOS icin: afplay + sox/rec + Whisper
+ * Cross-platform: openai-whisper API veya local whisper.cpp
+ */
+
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const { spawn } = require("child_process");
+const https = require("https");
+
+const IS_MAC = os.platform() === "darwin";
+
+/**
+ * Whisper API ile sesi metne cevir
+ */
+function whisperTranscribe(audioBuffer, provider = "openai") {
+  return new Promise((resolve, reject) => {
+    const apiKey = process.env.OPENAI_API_KEY || process.env.WHISPER_API_KEY;
+    if (!apiKey) {
+      reject(new Error("OPENAI_API_KEY gerekli (Whisper API icin)"));
+      return;
+    }
+
+    // multipart/form-data olustur
+    const boundary = "----formdata-" + Date.now();
+    const filename = "/tmp/audio-" + Date.now() + ".wav";
+
+    // Basit multipart builder
+    let body = Buffer.alloc(0);
+    body = Buffer.concat([body, Buffer.from(`--${boundary}\r\n`)]);
+    body = Buffer.concat([body, Buffer.from(`Content-Disposition: form-data; name="file"; filename="audio.wav"\r\n`)]);
+    body = Buffer.concat([body, Buffer.from(`Content-Type: audio/wav\r\n\r\n`)]);
+    body = Buffer.concat([body, audioBuffer]);
+    body = Buffer.concat([body, Buffer.from(`\r\n--${boundary}\r\n`)]);
+    body = Buffer.concat([body, Buffer.from(`Content-Disposition: form-data; name="model"\r\n\r\n`)]);
+    body = Buffer.concat([body, Buffer.from(`whisper-1`)]);
+    body = Buffer.concat([body, Buffer.from(`\r\n--${boundary}\r\n`)]);
+    body = Buffer.concat([body, Buffer.from(`Content-Disposition: form-data; name="language"\r\n\r\n`)]);
+    body = Buffer.concat([body, Buffer.from(`tr`)]);
+    body = Buffer.concat([body, Buffer.from(`\r\n--${boundary}--\r\n`)]);
+
+    const req = https.request({
+      hostname: "api.openai.com",
+      port: 443,
+      path: "/v1/audio/transcriptions",
+      method: "POST",
+      headers: {
+        "Authorization": `Bearer ${apiKey}`,
+        "Content-Type": `multipart/form-data; boundary=${boundary}`,
+        "Content-Length": body.length,
+      },
+      timeout: 30000,
+    }, res => {
+      let data = "";
+      res.on("data", c => data += c);
+      res.on("end", () => {
+        try {
+          const parsed = JSON.parse(data);
+          resolve(parsed.text || "");
+        } catch (e) {
+          reject(new Error("Whisper API yanit parse hatasi: " + data.slice(0, 200)));
+        }
+      });
+    });
+    req.on("error", reject);
+    req.on("timeout", () => req.destroy() && reject(new Error("Whisper timeout")));
+    req.write(body);
+    req.end();
+  });
+}
+
+/**
+ * macOS'ta mikrofondan ses kaydet
+ * "sox" veya "rec" komutunu kullanir
+ */
+function recordMac(durationSec = 5) {
+  return new Promise((resolve, reject) => {
+    const outFile = path.join(os.tmpdir(), `voice-${Date.now()}.wav`);
+
+    // sox varsa onu kullan, yoksa built-in "rec" (sox)
+    const proc = spawn("rec", [
+      "-r", "16000",           // 16kHz (Whisper icin ideal)
+      "-c", "1",               // mono
+      "-b", "16",              // 16-bit
+      outFile,
+      "trim", "0", String(durationSec),  // sure
+    ], { timeout: durationSec * 1000 + 5000 });
+
+    proc.on("close", (code) => {
+      if (code === 0 && fs.existsSync(outFile)) {
+        resolve(outFile);
+      } else {
+        reject(new Error("Ses kaydi basarisiz. Kur: brew install sox"));
+      }
+    });
+    proc.on("error", (e) => reject(new Error("'rec' komutu bulunamadi. brew install sox ile kur")));
+  });
+}
+
+/**
+ * macOS'ta text-to-speech (say)
+ */
+function macSay(text) {
+  return new Promise((resolve) => {
+    if (!text) return resolve({ success: false, error: "text bos" });
+    const proc = spawn("say", ["-v", "Yelda", text]);
+    proc.on("close", (code) => {
+      if (code === 0) resolve({ success: true, provider: "mac-say" });
+      else resolve({ success: false, error: `say exit ${code}` });
+    });
+    proc.on("error", (e) => resolve({ success: false, error: e.message }));
+  });
+}
+
+/**
+ * Voice chat — record → transcribe → reply → speak
+ */
+async function voiceChat({ action = "speak", text, durationSec = 5 } = {}) {
+  if (!IS_MAC) return { success: false, error: "Voice chat sadece macOS'ta" };
+
+  if (action === "record") {
+    try {
+      const audioFile = await recordMac(durationSec);
+      const buffer = fs.readFileSync(audioFile);
+      const text = await whisperTranscribe(buffer);
+      fs.unlinkSync(audioFile);
+      return { success: true, action: "record", text, message: `Algilanan: "${text}"` };
+    } catch (e) {
+      return { success: false, error: e.message };
+    }
+  }
+
+  if (action === "speak" || !action) {
+    if (!text) return { success: false, error: "text gerekli (speak icin)" };
+    return await macSay(text);
+  }
+
+  if (action === "test") {
+    // Setup check
+    try {
+      const outFile = path.join(os.tmpdir(), "voice-test.wav");
+      const proc = spawn("which", ["rec"]);
+      proc.on("close", (code) => {
+        if (code === 0) return { success: true, message: "Voice chat hazir" };
+      });
+      return { success: false, error: "'rec' komutu yok. brew install sox" };
+    } catch (e) {
+      return { success: false, error: e.message };
+    }
+  }
+
+  return { success: false, error: `Bilinmeyen action: ${action}` };
+}
+
+module.exports = {
+  name: "voice_chat",
+  description: "Sesli asistan: mikrofonla konus, Whisper ile metne cevir, yaniti sesli oku. macOS + sox gerekli.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      action: { type: "string", description: "record (konusarak yaz), speak (yaziyi sesli oku), test (hazir mi?)", enum: ["record", "speak", "test"] },
+      text: { type: "string", description: "Sesli okunacak metin (speak icin)" },
+      durationSec: { type: "number", description: "Kayit suresi (default 5)" },
+    },
+    required: [],
+  },
+  async execute(params) {
+    return await voiceChat(params);
+  },
+};

package/src/utils/error.js

@@ -0,0 +1,144 @@
+/**
+ * error.js — Standardized error handling (v5.3.1)
+ *
+ * Parton: "Teknik acidan kusursuz olalim"
+ * Tum tool'lar bu helper'i kullanir:
+ *   - Standart error format
+ *   - Retry stratejisi
+ *   - User-friendly messages
+ *   - Error codes
+ */
+
+class ToolError extends Error {
+  constructor(message, code = "TOOL_ERROR", details = {}) {
+    super(message);
+    this.name = "ToolError";
+    this.code = code;
+    this.details = details;
+    this.timestamp = new Date().toISOString();
+  }
+
+  toJSON() {
+    return {
+      success: false,
+      error: this.message,
+      code: this.code,
+      details: this.details,
+      timestamp: this.timestamp,
+    };
+  }
+}
+
+/**
+ * Standard error codes
+ */
+const ERROR_CODES = {
+  NOT_FOUND: "NOT_FOUND",           // Dosya/kaynak yok
+  PERMISSION: "PERMISSION_DENIED",  // macOS izin yok
+  INVALID_INPUT: "INVALID_INPUT",   // Kullanici yanlis input
+  NETWORK: "NETWORK_ERROR",         // API/connection hatasi
+  TIMEOUT: "TIMEOUT",               // Sure asimi
+  RATE_LIMIT: "RATE_LIMITED",       // API rate limit
+  AUTH: "AUTH_FAILED",              // API key gecersiz
+  PARTIAL: "PARTIAL_SUCCESS",       // Kismen basarili
+  INTERNAL: "INTERNAL_ERROR",       // Bug/mimari sorun
+};
+
+/**
+ * User-friendly error messages
+ */
+const FRIENDLY_MESSAGES = {
+  NOT_FOUND: {
+    file: "Dosya bulunamadi. Yolu kontrol edin.",
+    dir: "Klasor bulunamadi.",
+    app: "Uygulama bulunamadi. Mac'te kurulu mu?",
+    command: "Komut bulunamadi. PATH'te mi?",
+  },
+  PERMISSION: {
+    calendar: "Takvim erisim izni yok.\n\nIzin vermek icin:\n1. System Preferences → Security & Privacy → Privacy → Automation\n2. natureco (veya Terminal) → Calendar → ON",
+    reminders: "Hatirlatici izni yok. System Preferences → Security → Automation → Reminders → ON",
+    notes: "Notes erisim izni yok. System Preferences → Security → Automation → Notes → ON",
+    notifications: "Bildirim izni kapali. System Preferences → Notifications → natureco → ON",
+    microphone: "Mikrofon izni yok. System Preferences → Security → Microphone → ON",
+  },
+};
+
+/**
+ * Standart error response wrapper
+ */
+function errorResponse(message, code = ERROR_CODES.INTERNAL, details = {}) {
+  return {
+    success: false,
+    error: message,
+    code,
+    details,
+    timestamp: new Date().toISOString(),
+  };
+}
+
+/**
+ * Standart success response
+ */
+function successResponse(data, message = null) {
+  return {
+    success: true,
+    ...data,
+    message,
+    timestamp: new Date().toISOString(),
+  };
+}
+
+/**
+ * Execute with retry — network errors icin otomatik tekrar
+ */
+async function executeWithRetry(fn, options = {}) {
+  const { maxRetries = 2, retryDelayMs = 1000, retryOn = ["NETWORK_ERROR", "TIMEOUT"] } = options;
+  let lastError;
+
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (e) {
+      lastError = e;
+      const isRetryable = retryOn.some(code =>
+        e.message?.includes(code) ||
+        e.code === code ||
+        (e.name === "AbortError")
+      );
+      if (!isRetryable || attempt === maxRetries) {
+        throw e;
+      }
+      await new Promise(r => setTimeout(r, retryDelayMs * (attempt + 1)));
+    }
+  }
+  throw lastError;
+}
+
+/**
+ * macOS permission check
+ */
+async function checkMacPermission(appName) {
+  if (os.platform() !== "darwin") return true;
+  const { spawn } = require("child_process");
+  return new Promise((resolve) => {
+    const proc = spawn("osascript", ["-e", `tell application "System Events" to return name of every process`]);
+    let stdout = "";
+    proc.stdout.on("data", d => stdout += d);
+    proc.on("close", (code) => {
+      // System Events calisabiliyorsa, genel Automation izni var
+      // Spesifik app icin test zor — genelde user'a "izin ver" diyoruz
+      resolve(code === 0);
+    });
+    proc.on("error", () => resolve(false));
+  });
+}
+
+module.exports = {
+  ToolError,
+  ERROR_CODES,
+  FRIENDLY_MESSAGES,
+  errorResponse,
+  successResponse,
+  executeWithRetry,
+  checkMacPermission,
+};