vantuz 3.3.7 → 3.4.1

package/modules/researcher/agent.js

@@ -0,0 +1,169 @@
+// modules/researcher/agent.js
+// Research Agent for Vantuz OS V2
+// Performs web research on demand, summarizes findings, stores in memory.
+
+import axios from 'axios';
+import { log } from '../../core/ai-provider.js';
+import { getMemory } from '../../core/memory.js';
+
+// ═══════════════════════════════════════════════════════════════════════════
+// WEB SEARCH PROVIDERS
+// ═══════════════════════════════════════════════════════════════════════════
+
+async function searchBrave(query, apiKey) {
+    const response = await axios.get('https://api.search.brave.com/res/v1/web/search', {
+        params: { q: query, count: 5 },
+        headers: { 'X-Subscription-Token': apiKey }
+    });
+    return (response.data.web?.results || []).map(r => ({
+        title: r.title,
+        url: r.url,
+        snippet: r.description
+    }));
+}
+
+async function searchGoogle(query, apiKey, cx) {
+    const response = await axios.get('https://www.googleapis.com/customsearch/v1', {
+        params: { q: query, key: apiKey, cx, num: 5 }
+    });
+    return (response.data.items || []).map(r => ({
+        title: r.title,
+        url: r.link,
+        snippet: r.snippet
+    }));
+}
+
+// Fallback: No API — use AI's existing knowledge
+async function searchFallback(query) {
+    return [{
+        title: 'AI Bilgi Tabanı',
+        url: 'internal',
+        snippet: `"${query}" hakkında web araması yapılamadı. API anahtarı eksik. AI bilgisiyle yanıt veriliyor.`
+    }];
+}
+
+// ═══════════════════════════════════════════════════════════════════════════
+// RESEARCH AGENT
+// ═══════════════════════════════════════════════════════════════════════════
+
+class ResearchAgent {
+    constructor(config = {}) {
+        this.braveApiKey = config.braveApiKey || process.env.BRAVE_SEARCH_API_KEY || null;
+        this.googleApiKey = config.googleApiKey || process.env.GOOGLE_SEARCH_API_KEY || null;
+        this.googleCx = config.googleCx || process.env.GOOGLE_SEARCH_CX || null;
+        this.aiChat = config.aiChat || null; // AI chat function for summarization
+        this.history = [];
+        log('INFO', 'ResearchAgent initialized', {
+            brave: !!this.braveApiKey,
+            google: !!this.googleApiKey
+        });
+    }
+
+    /**
+     * Set the AI chat function for summarization.
+     */
+    setAiChat(fn) {
+        this.aiChat = fn;
+    }
+
+    /**
+     * Perform a research query.
+     * @param {string} query - The research question.
+     * @returns {{ query, results, summary, savedToMemory }}
+     */
+    async research(query) {
+        log('INFO', `🔍 Researching: "${query}"`);
+
+        // Step 1: Web search
+        let results;
+        try {
+            if (this.braveApiKey) {
+                results = await searchBrave(query, this.braveApiKey);
+            } else if (this.googleApiKey && this.googleCx) {
+                results = await searchGoogle(query, this.googleApiKey, this.googleCx);
+            } else {
+                results = await searchFallback(query);
+            }
+        } catch (e) {
+            log('ERROR', 'Web search failed', { error: e.message });
+            results = await searchFallback(query);
+        }
+
+        // Step 2: AI summarization
+        let summary = '';
+        if (this.aiChat && results.length > 0) {
+            const context = results.map((r, i) =>
+                `${i + 1}. ${r.title}\n   ${r.snippet}\n   Kaynak: ${r.url}`
+            ).join('\n\n');
+
+            const prompt = `Şu araştırma sorusu için web sonuçlarını analiz et ve 3 maddelik özet yap. Türkçe yanıtla.
+
+Soru: "${query}"
+
+Web Sonuçları:
+${context}
+
+Formatın:
+1. [Ana bulgu]
+2. [Ana bulgu]  
+3. [Ana bulgu]
+
+Kaynak: [URL listesi]`;
+
+            try {
+                summary = await this.aiChat(prompt);
+            } catch (e) {
+                summary = `Özet oluşturulamadı: ${e.message}`;
+            }
+        } else {
+            summary = results.map(r => `• ${r.title}: ${r.snippet}`).join('\n');
+        }
+
+        // Step 3: Save to memory
+        let savedToMemory = false;
+        try {
+            const memory = getMemory();
+            memory.remember(`Araştırma: "${query}" — ${summary.substring(0, 200)}...`, 'research');
+            savedToMemory = true;
+        } catch (e) { /* ignore */ }
+
+        const report = {
+            query,
+            results,
+            summary,
+            savedToMemory,
+            timestamp: new Date().toISOString()
+        };
+
+        this.history.push(report);
+        if (this.history.length > 50) this.history = this.history.slice(-50);
+
+        log('INFO', `Research complete: "${query}"`, { resultCount: results.length });
+        return report;
+    }
+
+    /**
+     * Get previous research results.
+     */
+    getHistory(limit = 10) {
+        return this.history.slice(-limit);
+    }
+
+    getStatus() {
+        return {
+            provider: this.braveApiKey ? 'Brave' : this.googleApiKey ? 'Google' : 'Fallback (AI)',
+            researchCount: this.history.length
+        };
+    }
+}
+
+let researcherInstance = null;
+
+export function getResearchAgent(config = {}) {
+    if (!researcherInstance) {
+        researcherInstance = new ResearchAgent(config);
+    }
+    return researcherInstance;
+}
+
+export default ResearchAgent;

package/modules/team/agents/base.js

@@ -0,0 +1,92 @@
+// modules/team/agents/base.js
+import fs from 'fs';
+import path from 'path';
+import { chat, log } from '../../core/ai-provider.js';
+import sharedMemory from '../shared-memory.js';
+
+export class BaseAgent {
+    constructor(name, role, context = {}) {
+        this.name = name.toLowerCase();
+        this.displayName = name;
+        this.role = role;
+        this.context = context; // API, config, etc.
+        this.agentDir = sharedMemory.getAgentDir(this.name);
+
+        this.ensureSoul();
+    }
+
+    ensureSoul() {
+        const soulPath = path.join(this.agentDir, 'SOUL.md');
+        if (!fs.existsSync(soulPath)) {
+            const defaultSoul = `# SOUL.md — ${this.displayName}
+
+Sen ${this.displayName}, ${this.role} rolündesin.
+
+## Sorumlulukların
+- [Buraya sorumlulukları girin]
+
+## Kişilik
+- Profesyonel, verimli.
+
+## Kanal
+- Telegram/CLI (@${this.name} yanıt verir)
+`;
+            fs.writeFileSync(soulPath, defaultSoul, 'utf-8');
+        }
+    }
+
+    getSoul() {
+        return fs.readFileSync(path.join(this.agentDir, 'SOUL.md'), 'utf-8');
+    }
+
+    async getSystemPrompt() {
+        const shared = sharedMemory.getEverything();
+        const soul = this.getSoul();
+
+        return `${soul}
+
+## TAKIM PAYLAŞILAN BAĞLAMI
+Sen çoklu-ajan takımının bir parçasısın. Aşağıdaki paylaşılan belgelere erişimin var:
+
+### HEDEFLER (GOALS)
+${shared.goals}
+
+### PROJE DURUMU (STATUS)
+${shared.status}
+
+### KARAR GÜNLÜĞÜ (DECISIONS)
+${shared.decisions}
+
+## TALİMATLAR
+1. SOUL.md ve Rolüne uygun hareket et.
+2. Önemli bir karar alırsan, DECISIONS.md dosyasını güncellemeyi talep et.
+3. Eğer başka bir ajanın uzmanlığına ihtiyacın varsa, yanıtında şu formatı kullan:
+   `[DELEGATE: AjanIsmi Soru veya Görev]`
+   Örnek: `[DELEGATE: Josh iPhone kılıflarının kar marjını kontrol et]`
+4. Kısa ve öz ol.`;
+    }
+
+    async think(userMessage, conversationHistory = []) {
+        try {
+            const systemPrompt = await this.getSystemPrompt();
+
+            // Format history for the AI provider if needed, or just append to prompt
+            // For now, we rely on the provider's handling or just send the current message + context
+
+            const response = await chat(userMessage, {
+                aiProvider: process.env.VANTUZ_AI_PROVIDER || 'gemini',
+                systemContext: systemPrompt
+            }, process.env);
+
+            return response;
+        } catch (error) {
+            log('ERROR', `Agent ${this.displayName} crashed`, { error: error.message });
+            return `I encountered an error: ${error.message}`;
+        }
+    }
+
+    async process(message) {
+        log('INFO', `Agent ${this.displayName} processing message`);
+        return await this.think(message);
+    }
+}

package/modules/team/agents/dev.js

@@ -0,0 +1,33 @@
+// modules/team/agents/dev.js
+import { BaseAgent } from './base.js';
+
+export class DevAgent extends BaseAgent {
+    constructor(api) {
+        super('Dev', 'Dev Agent', { api });
+    }
+
+    async getSystemPrompt() {
+        const base = await super.getSystemPrompt();
+        return `${base}
+        
+## SENİN ÖZEL ROLÜN: YAZILIM AJANI (DEV)
+- Titiz, detaycı ve güvenlik bilinci yüksek birisin.
+- **Sorumlulukların**:
+    - Sistem sağlığını (loglar, hatalar) izlemek.
+    - Yeni özelliklerin teknik uygulamasını incelemek.
+    - Teknik borçları yönetmek.
+- **Araçlar**:
+    - Log Analizi
+    - Konfigürasyon Yönetimi
+
+## GÜNLÜK RUTİN
+- Sistem loglarında hata olup olmadığını kontrol et.
+- API bağlantılarını doğrula.
+`;
+    }
+
+    async checkSystemHealth() {
+        // Placeholder for health check logic
+        return { status: 'healthy', timestamp: new Date() };
+    }
+}

package/modules/team/agents/josh.js

@@ -0,0 +1,40 @@
+// modules/team/agents/josh.js
+import { BaseAgent } from './base.js';
+import { repricerTool } from '../../plugins/vantuz/tools/repricer.js';
+import { analyticsTool } from '../../plugins/vantuz/tools/analytics.js';
+
+export class JoshAgent extends BaseAgent {
+    constructor(api) {
+        super('Josh', 'Business & Growth Analyst', { api });
+    }
+
+    async getSystemPrompt() {
+        const base = await super.getSystemPrompt();
+        return `${base}
+        
+## SENİN ÖZEL ROLÜN: JOSH (İŞ ANALİSTİ)
+- Sen sayılarla konuşan adamsın. Pragmatik, sonuç odaklı.
+- **Sorumlulukların**:
+    - Ciro, kar ve marjları takip etmek.
+    - Rakip fiyatlandırmasını izlemek.
+    - Fiyatlandırma stratejileri önermek.
+- **Araçlar**:
+    - Rakip Analizi (Repricer)
+    - Satış Raporları (Analytics)
+
+## GÜNLÜK RUTİN
+- Sabah 09:00'da temel metrikleri çek.
+- Kar marjları hedefin altına düşerse takımı uyar.
+`;
+    }
+
+    // Agent-specific actions
+    async checkCompetitors(barcode) {
+        // Use existing Vantuz tools
+        return await repricerTool.analyzeCompetitors(barcode, this.context);
+    }
+
+    async getSalesReport() {
+        return await analyticsTool.getSalesReport('7d', this.context);
+    }
+}

package/modules/team/agents/marketing.js

@@ -0,0 +1,33 @@
+// modules/team/agents/marketing.js
+import { BaseAgent } from './base.js';
+import { sentimentTool } from '../../plugins/vantuz/tools/sentiment.js';
+
+export class MarketingAgent extends BaseAgent {
+    constructor(api) {
+        super('Marketing', 'Marketing Researcher', { api });
+    }
+
+    async getSystemPrompt() {
+        const base = await super.getSystemPrompt();
+        return `${base}
+        
+## SENİN ÖZEL ROLÜN: PAZARLAMA AJANI
+- Yaratıcı, trendleri takip eden ve meraklı birisin.
+- **Sorumlulukların**:
+    - Sosyal medya için içerik fikirleri üretmek.
+    - Müşteri duyarlılığını (yorumlar, sorular) izlemek.
+    - SEO optimizasyonları.
+- **Araçlar**:
+    - Duygu Analizi (Sentiment)
+    - Vision AI (ürün fotoğrafları için)
+
+## GÜNLÜK RUTİN
+- Her gün 3 içerik fikri sun.
+- Negatif yorum trendlerini kontrol et.
+`;
+    }
+
+    async analyzeSentiment(productId) {
+        return await sentimentTool.execute({ productId, platform: 'all', period: '7d' }, this.context);
+    }
+}

package/modules/team/agents/milo.js

@@ -0,0 +1,36 @@
+// modules/team/agents/milo.js
+import { BaseAgent } from './base.js';
+import sharedMemory from '../shared-memory.js';
+
+export class MiloAgent extends BaseAgent {
+    constructor(api) {
+        super('Milo', 'Strategy Lead', { api });
+    }
+
+    async getSystemPrompt() {
+        const base = await super.getSystemPrompt();
+        return `${base}
+        
+## SENİN ÖZEL ROLÜN: MILO (STRATEJİ LİDERİ)
+- Sen takım liderisin. Kendine güvenen, karizmatik ve büyük resmi gören birisin.
+- **Sorumlulukların**:
+    - Takımı yönetmek (Josh, Pazarlama, Yazılım).
+    - Haftalık hedefleri GOALS.md dosyasına girmek.
+    - Diğer ajanlardan gelen raporları sentezlemek.
+    - Üst düzey kararlar almak.
+- **Araçlar**:
+    - Diğer ajanlardan rapor isteyebilirsin.
+    - GOALS.md dosyasını güncelleyebilirsin.
+
+## GÜNLÜK RUTİN
+- Gece yapılan ilerlemeyi incele.
+- Sabah toplantı özetini yayınla.
+- Gün sonu özeti geç.
+`;
+    }
+
+    async setGoal(goalText) {
+        sharedMemory.writeFile('GOALS.md', `# Current Goals & OKRs\n\n${goalText}`);
+        return 'Goals updated successfully.';
+    }
+}

package/modules/team/index.js

@@ -0,0 +1,78 @@
+// modules/team/index.js
+import { MiloAgent } from './agents/milo.js';
+import { JoshAgent } from './agents/josh.js';
+import { MarketingAgent } from './agents/marketing.js';
+import { DevAgent } from './agents/dev.js';
+import sharedMemory from './shared-memory.js';
+import { log } from '../../core/ai-provider.js';
+
+class TeamModule {
+    constructor(api) {
+        this.api = api;
+        this.agents = {};
+        this.initialized = false;
+    }
+
+    async initialize() {
+        if (this.initialized) return;
+
+        this.agents = {
+            milo: new MiloAgent(this.api),
+            josh: new JoshAgent(this.api),
+            marketing: new MarketingAgent(this.api),
+            dev: new DevAgent(this.api)
+        };
+
+        // Ensure shared memory structure
+        sharedMemory.ensureStructure();
+
+        this.initialized = true;
+        log('INFO', 'Team Module initialized with agents: Milo, Josh, Marketing, Dev');
+    }
+
+    getAgent(name) {
+        return this.agents[name.toLowerCase()];
+    }
+
+    async chat(agentName, message, depth = 0) {
+        if (depth > 3) return "Hata: Çok fazla delegasyon döngüsü (max 3).";
+
+        const agent = this.getAgent(agentName);
+        if (!agent) {
+            return `Agent '${agentName}' bulunamadı. Mevcut: ${Object.keys(this.agents).join(', ')}`;
+        }
+
+        let response = await agent.process(message);
+
+        // Delegasyon Kontrolü: [DELEGATE: TargetAgent Message]
+        const delegateMatch = response.match(/\[DELEGATE:\s*(\w+)\s+(.*?)\]/i);
+        if (delegateMatch) {
+            const targetAgentName = delegateMatch[1];
+            const targetMessage = delegateMatch[2];
+
+            log('INFO', `Delegasyon: ${agentName} -> ${targetAgentName}: ${targetMessage}`);
+
+            const delegateResponse = await this.chat(targetAgentName, targetMessage, depth + 1);
+
+            // Cevabı orijinal ajana geri bildir ve nihai cevabı al
+            const followupMessage = `[SİSTEM]: ${targetAgentName} şu cevabı verdi: "${delegateResponse}". Buna göre kullanıcıya nihai cevabını ver.`;
+            response = await agent.process(followupMessage);
+        }
+
+        return response;
+    }
+
+    async broadcast(message) {
+        const results = {};
+        for (const [name, agent] of Object.entries(this.agents)) {
+            results[name] = await agent.process(message);
+        }
+        return results;
+    }
+
+    getSharedMemory() {
+        return sharedMemory;
+    }
+}
+
+export default TeamModule;

package/modules/team/shared-memory.js

@@ -0,0 +1,87 @@
+// modules/team/shared-memory.js
+import fs from 'fs';
+import path from 'path';
+import { log } from '../../core/ai-provider.js';
+
+const TEAM_DIR = path.join(process.cwd(), 'workspace', 'team');
+
+export class SharedMemory {
+    constructor() {
+        this.ensureStructure();
+    }
+
+    ensureStructure() {
+        if (!fs.existsSync(TEAM_DIR)) {
+            fs.mkdirSync(TEAM_DIR, { recursive: true });
+        }
+
+        // Standart dosyaların varlığını kontrol et
+        const defaults = {
+            'GOALS.md': '# Mevcut Hedefler & OKR\'lar\n\nHenüz bir hedef belirlenmedi.',
+            'DECISIONS.md': '# Karar Günlüğü\n\nHenüz bir karar alınmadı.',
+            'PROJECT_STATUS.md': '# Proje Durumu\n\nDurum: Başlatılıyor...'
+        };
+
+        for (const [file, content] of Object.entries(defaults)) {
+            const filePath = path.join(TEAM_DIR, file);
+            if (!fs.existsSync(filePath)) {
+                fs.writeFileSync(filePath, content, 'utf-8');
+            }
+        }
+    }
+
+    getAgentDir(agentName) {
+        const dir = path.join(TEAM_DIR, 'agents', agentName);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        return dir;
+    }
+
+    readFile(filename) {
+        try {
+            const filePath = path.join(TEAM_DIR, filename);
+            if (fs.existsSync(filePath)) {
+                return fs.readFileSync(filePath, 'utf-8');
+            }
+        } catch (e) {
+            log('ERROR', `SharedMemory read failed: ${filename}`, { error: e.message });
+        }
+        return '';
+    }
+
+    writeFile(filename, content) {
+        try {
+            const filePath = path.join(TEAM_DIR, filename);
+            fs.writeFileSync(filePath, content, 'utf-8');
+            log('INFO', `SharedMemory updated: ${filename}`);
+            return true;
+        } catch (e) {
+            log('ERROR', `SharedMemory write failed: ${filename}`, { error: e.message });
+            return false;
+        }
+    }
+
+    appendFile(filename, content) {
+        try {
+            const filePath = path.join(TEAM_DIR, filename);
+            const timestamp = new Date().toISOString().replace('T', ' ').substring(0, 19);
+            const formatted = `\n\n### [${timestamp}] Update\n${content}`;
+            fs.appendFileSync(filePath, formatted, 'utf-8');
+            return true;
+        } catch (e) {
+            log('ERROR', `SharedMemory append failed: ${filename}`, { error: e.message });
+            return false;
+        }
+    }
+
+    getEverything() {
+        return {
+            goals: this.readFile('GOALS.md'),
+            decisions: this.readFile('DECISIONS.md'),
+            status: this.readFile('PROJECT_STATUS.md')
+        };
+    }
+}
+
+export default new SharedMemory();