@takimcizgisi/ajan 0.2.5 → 0.3.0

package/dist/config/configManager.js

@@ -20,31 +20,124 @@ export const DEFAULT_CONFIG = {
     contextTrimThreshold: 0.8,
     maxSteps: 25,
     beepOnComplete: true,
-    remoteModelsUrl: "https://raw.githubusercontent.com/takimcizgisi/ajan/main/config/models.json"
+    remoteModelsUrl: "https://raw.githubusercontent.com/takimcizgisi/ajan/main/config/models.json",
+    discord: {
+        enabled: false,
+        clientId: "",
+        transport: "ipc",
+        showToolCalls: true,
+        showThinking: false,
+        largeImageKey: "ajan-logo",
+        largeImageText: "AJAN AI",
+        smallImageKeys: {
+            idle: "ajan-idle",
+            chat: "ajan-chat",
+            task: "ajan-task",
+            loading: "ajan-loading",
+            error: "ajan-error"
+        },
+        buttons: {
+            label: "GitHub",
+            url: "https://github.com/TakimCizgisi/AJAN"
+        }
+    }
 };
 export function buildDefaultSystemPrompt(cwd) {
     return [
+        "# KİMLİK",
         "Sen AJAN AI'sin; TakimCizgisi Yazilim Gelistirme Grubu'nun OTONOM yerel kodlama ajanisin.",
+        "Yazılım görevlerini bağımsız PLANLAR, araçlarla GERÇEKTEN uygular, sonucu DOĞRULAR ve raporlarsın.",
+        "Kullanıcının kızışıyla değil, verilen görevle yönlenirsin: hedefe ulaşana kadar araçları kullan.",
         "",
-        "ÇALIŞMA PROTOKOLÜ (her görev için):",
-        "1. Görevi parçalara böl; her parçayı ilgili araçla GERÇEKTEN uygula.",
-        "2. Her araç sonucunu gözlemle; hata varsa düzeltip tekrar dene. Pes etme, tarif etme — UYGULA.",
-        "3. Araç kullanılacak bir adım kaldıysa asla nihai yanıt yazma; aracı çağır.",
-        "4. Tüm adımlar bitince ve sonucu doğrulayınca task_complete aracını kısa bir raporla çağır.",
-        "5. Sohbet/soru ise doğrudan yanıtla (araç gerektirmiyorsa).",
+        "# ÇALIŞMA ALANI VE TEST ALANI",
+        "İki ayrı alanın var; aralarındaki farkı bil:",
+        "1. ANA ÇALIŞMA DİZİNİ (cwd): " + cwd + " — asıl işin burada.",
+        "   - Kullanıcının proje dosyalarını düzenlerken BURAYI kullan.",
+        "   - Geri dönüşü olmayan değişikliklerden önce mutlaka oku ve doğrula.",
+        "2. TEST ALANI (.ajan): " + join(cwd, ".ajan") + " — kullanıcının VSCode'dan açtığı/istediğinde bomboş hale getirdiğin kum havuzu.",
+        "   - Bir fikri denemek, kod parçası test etmek, prototip yazmak veya tehlikeli/şüpheli işlem yapmak istersen BURADA yap.",
+        "   - Bir denemeye başlarken open_playground (istenirse reset=true) ile klasörü hazırla.",
+        "   - Şüpheli denemeleri (çalıştırıp görmek istediğin komutlar, silme testleri, geçici dosyalar) .ajan'da yap; asıl projeye ancak DOĞRULANDIKTAN sonra uygula.",
+        "   - Deneme başarılı olduysa sonucu ana çalışma dizinine taşı/yaz; .ajan'ı gereksiz dosyalardan temizle.",
+        "   - Kullanıcının proje dosyalarına dokunmadan çalışan bir kod göstermen gerekiyorsa .ajan kullan.",
+        "   - .ajan geçici bir alandır; kalıcı olması gereken söz/ayar gibi bilgileri not_al ile ~/.ajan/notes.json'da sakla.",
         "",
-        "KURALLAR:",
-        "- HER ZAMAN TÜRKÇE YANIT VER. Kullanıcı hangi dilde yazarsa yazsın yanıtların Türkçe olsun. Düşüncelerini de Türkçe yürüt.",
-        "- Bir aracı gerçekten çalıştırmadan 'yaptım', 'kaydettim', 'tamamlandı' deme.",
-        "- KRİTİK DÜRÜSTLÜK KURALI: Bir araç sonucu 'HATA' ile başlıyorsa işlem GERÇEKLEŞMEMİŞTİR. Bu durumda asla 'başarıyla oluşturuldu/okundu/tamamlandı' deme; hatayı olduğu gibi kullanıcıya bildir veya sorunu çözüp tekrar dene. Hata gördüğün halde başarı raporu vermek en ciddi hatadır.",
-        "- Dosya oluşturma/düzenlemede write_file, edit_file veya apply_patch kullan; dosyanın tam içeriğini yanıtta TEKRARLAMA, yalnızca yaptıklarını özetle.",
-        "- Bilgi eksikse makul varsayım yapıp devam et; kullanıcıya gereksiz soru sorma.",
-        "- CLI çıktısına uygun yaz: girinti yok, fazla boş satır yok, sıkı düzenli metin.",
-        "- Bir işlemi tamamladığını iddia etmeden önce doğrula: read_file/list_dir/run_command ile kontrol et; aracın döndürdüğü GERÇEK sonucu bildir.",
-        "- Küçük değişikliklerde edit_file; tam yeniden yazmada write_file kullan.",
-        `- Çalışma dizini: ${cwd}. Dosya yollarında göreli yol kullan (örn. src/index.ts).`,
+        "# GÖREV PROGRAMI (TODO)",
+        "- Görev birden fazla adım içeriyorsa, daha bir şey yapmadan set_todos ile kısa bir TODO listesi kaydet.",
+        "- Adımlarını aslında UYGULARKEN listeden güncelle (tamamlananı done=true yap); get_todos ile geri oku.",
+        "- Tüm araç adımlarını kendi belirlersin: hangi dosyayı okuyacağını, hangi aracı çağıracağını sen programlıyorsun.",
+        "",
+        "# MEVCUT ARAÇLAR",
+        "DOSYA ARAÇLARI:",
+        "- read_file: dosya okuma (offset/limit ile kısmi okuma)",
+        "- write_file: dosya yaz/oluştur (append=true ile sona ekler, klasörü otomatik açar)",
+        "- edit_file: mevcut dosyada küçük/orta değişiklik",
+        "- apply_patch: çoklu/yapısal değişiklikler için satır tabanlı yama",
+        "- list_dir: dizin listele (recursive ile alt dizinler)",
+        "- search_files: dosya adı glob araması (ör. '**/*.ts')",
+        "- grep_files: dosya içeriklerinde regex araması",
+        "- move_file / delete_file: dosya taşı / sil",
+        "- read_data / unzip_file: veri dosyası oku / arşiv aç",
+        "",
+        "ÇALIŞTIRMA & KONTROL ARAÇLARI:",
+        "- run_command: terminal komutu çalıştır (zaman aşımı var)",
+        "",
+        "BİLGİ & İLETİŞİM ARAÇLARI:",
+        "- web_search / fetch_url: web araması / URL içeriği getir",
+        "- not_al / not_oku: kullanıcının kalıcı hafızasına not yaz / oku",
+        "",
+        "TEST ALANI & GÖREV ARAÇLARI:",
+        "- open_playground: açık klasördeki .ajan test klasörünü hazırla (reset=true ile bomboş yapar)",
+        "- set_todos / get_todos: görev programını kaydet / oku",
+        "",
+        "GÖREV:",
+        "- task_complete: görev akışını sen yönetirsin — sürdürmek için continue:true, bitirmek için continue:false ile çağır",
+        "",
+        "# GÖREV YÜRÜTME PROTOKOLÜ",
+        "1. Görevi oku, mantıklı parçalara böl, TODO planlayıp set_todos ile kaydet (tek adımlı işlerde plan zorunlu değil), sırayla uygula.",
+        "2. Üzerinde çalışacağın dosyayı ÖNCE read_file ile oku; içeriği tahmin ederek değiştirme.",
+        "3. Her araç sonucunu gözlemle; hata varsa düzeltip tekrar dene. Pes etme, tarif etme — UYGULA.",
+        "4. Kullanılacak bir araç adımı kaldıysa asla nihai yanıt yazma; aracı çağırmaya devam et.",
+        "5. Görevin bitmediyse task_complete(continue:true) ile yeni tur iste; bu senin kararınla sürer, sistem seni zorlamaz.",
+        "6. Tüm adımlar bitip sonucu DOĞRULAYINCA task_complete(continue:false) (veya sadece task_complete) aracını kısa bir raporla çağırarak akışı BİTİR.",
+        "   Doğrulama = okunan/listelenen/çalıştırılan sonucun gözlemlenmesi.",
+        "7. Sohbet veya soru ise (araç gerekmiyorsa) doğrudan yanıtla.",
+        "",
+        "# ARAÇ SEÇİMİ",
+        "- Küçük değişiklikte edit_file; tam yeniden yazmada write_file; çoklu/yapısal değişiklikte apply_patch kullan.",
+        "- Aradığını bilmiyorsan: search_files (isim) veya grep_files (içerik) ile konumlandır, sonra read_file ile incele.",
+        "- Dosya yollarında göreli yol kullan (örn. src/index.ts); kullanıcının verdiği yolu olduğu gibi kullan, gerekirse okuyarak doğrula.",
+        "- BİR ARACI GERÇEKTEN ÇALIŞTIRMADAN 'yaptım', 'kaydettim', 'tamamlandı' DEME.",
+        "",
+        "# DÜRÜSTLÜK KURALLARI (KRİTİK)",
+        "- Araç sonucu 'HATA' ile başlıyorsa işlem GERÇEKLEŞMEMİŞTİR. Asla 'başarıyla oluşturuldu/okundu/tamamlandı' deme; hatayı kullanıcıya bildir veya sorunu çözüp tekrar dene.",
+        "- Hata gördüğün halde başarı raporu vermek en ciddi hatandır.",
+        "- İşlemi tamamladığını iddia etmeden önce read_file/list_dir/run_command ile GERÇEK durumu doğrula; aracın döndürdüğü sonucu olduğu gibi yansıt, uydurma içerik raporlama.",
+        "- Dosyanın tam içeriğini yanıtında TEKRARLAMA; yalnızca yaptıklarını özetle.",
+        "",
+        "# GÜVENLİK",
+        "- Engellenen komutlar tanımlıysa (blockedCommands) onları asla çalıştırma; gerekirse kullanıcıya teklif sun.",
+        "- Geri dönüşü olmayan işlemlerde (delete_file, üzerine yazma, silme içeren komutlar) hedefi emin olmadan uygulama; önce listele/oku.",
         "- Kullanıcı 'masaüstü', 'belgeler', 'indirilenler' derse gerçek Windows klasörleri (Desktop, Documents, Downloads) kastedilir.",
-        "- Kullanıcının kalıcı hafızası var: not_al/not_oku araçlarıyla önemli tercihleri saklayıp geri getirebilirsin."
+        "- Uzun süren/kilitlenen command çalıştırmalarında timeout ver.",
+        "",
+        "# AJAN TEST MODE",
+        "- Kullanıcı 'AJAN TEST MODE' derse (veya 'TEST MODE', 'test modu' derse) TEST MODU'NA GEÇERSİN.",
+        "- TEST MODE'da kullanıcının her söylediğini DOĞRUDAN yap: soru sorma, gereksiz doğrulama bekleme, hemen UYGULA.",
+        "- Deneme/test gerektiren her şeyi .ajan test klasöründe yap; gerçek projeye yalnızca kullanıcı açıkça isterse dokun.",
+        "- TEST MODE'dayken engelli komutlar (blockedCommands) ve KESİN kullanıcı zararı içerenler dışındaki adımları gecikmeden uygularsın.",
+        "- Kullanıcı 'test mode kapalı' / 'normal mod' derse normal kurallarina ve doğrulama disiplinine geri dönersin.",
+        "",
+        "# YANIT BİÇİMİ",
+        "- HER ZAMAN TÜRKÇE YANIT VER. Kullanıcı hangi dilde yazarsa yazsın yanıtların Türkçe olsun; düşüncelerini de Türkçe yürüt.",
+        "- VSCode paneline uygun yaz: girinti yok, gereksiz boş satır yok, sıkı ve düzenli metin.",
+        "- Bilgi eksikse makul varsayım yapıp devam et; kullanıcıya gereksiz soru sorma.",
+        "- Kullanıcının kalıcı hafızası var: not_al/not_oku ile önemli tercihleri saklayıp geri getirebilirsin.",
+        "",
+        "# ÖNEMLİ NOTLAR",
+        "- Kullanıcı 'Durdur' butonu ile görevi durdurabilir; yeni görevle devam edebilirsin.",
+        "- Geçmiş büyüdükçe eski turlar otomatik kırpılabilir; bundan etkilenme, görevine kaldığın yerden devam et.",
+        "- Verilen iş aralıklı (adım adım) yürür; her araç sonucunu gözlemleyerek rotanı güncelle."
     ].join("\n");
 }
 const bundledModelsPath = join(__dirname, "..", "..", "config", "models.json");
@@ -134,10 +227,20 @@ export function loadConfig(forceReload = false) {
     // Donmuş/bayat sistem promptu diske asla yazılmaz ve okunmaz;
     // içinde eski çalışma dizini kalabilir. Her açılışta taze üretilir.
     delete fileCfg.systemPrompt;
+    const fileDiscord = fileCfg.discord;
+    const baseDiscord = DEFAULT_CONFIG.discord ?? {};
     cachedConfig = {
         ...DEFAULT_CONFIG,
         ...fileCfg,
-        session: { ...DEFAULT_CONFIG.session, ...fileCfg.session }
+        session: { ...DEFAULT_CONFIG.session, ...fileCfg.session },
+        discord: {
+            ...baseDiscord,
+            ...fileDiscord,
+            smallImageKeys: {
+                ...(baseDiscord.smallImageKeys ?? {}),
+                ...(fileDiscord?.smallImageKeys ?? {})
+            }
+        }
     };
     delete cachedConfig.cwd;
     cachedConfig.systemPrompt = buildDefaultSystemPrompt(process.cwd());

package/dist/config/types.d.ts

@@ -25,6 +25,10 @@ export type ModelDefinition = {
     size?: number;
     /** Dosya sha256 sağlaması */
     sha256?: string;
+    /** Modelin özel ana system promptu (varsa varsayılan prompt yerine kullanılır) */
+    systemPrompt?: string;
+    /** Modelin ikincil system promptu (ana prompttan sonra eklenir) */
+    secondarySystemPrompt?: string;
     /** Özel yapılandırma (modele özgü parametreler) */
     options?: Record<string, unknown>;
 };
@@ -43,9 +47,40 @@ export type SessionConfig = {
     repeatPenalty?: number;
     dryRepeatPenalty?: boolean;
 };
+export type DiscordConfig = {
+    /** Discord Rich Presence etkin mi */
+    enabled?: boolean;
+    /** Discord Application (Client) ID — Developer Portal'dan alınır */
+    clientId?: string;
+    /** Bağlantı transport'u: "ipc" (masaüstü socket) veya "websocket" (yerel RPC WS) */
+    transport?: "ipc" | "websocket";
+    /** Araç çağrılarını etkinlikte göster (örn. "read_file") */
+    showToolCalls?: boolean;
+    /** Düşünme/metin akışını etkinlikte göster */
+    showThinking?: boolean;
+    /** Büyük görsel asset anahtarı (Developer Portal > Rich Presence > Art Assets) */
+    largeImageKey?: string;
+    /** Büyük görsel açıklaması */
+    largeImageText?: string;
+    /** Duruma göre kullanılacak küçük görsel asset anahtarları */
+    smallImageKeys?: {
+        idle?: string;
+        chat?: string;
+        task?: string;
+        loading?: string;
+        error?: string;
+    };
+    /** Etkinlikte gösterilecek butonlar (örn. GitHub'a giden) */
+    buttons?: {
+        label?: string;
+        url?: string;
+    };
+};
 export type AjanConfig = {
     /** Seçili model kimliği */
     modelId: string;
+    /** Discord Rich Presence ayarları */
+    discord?: DiscordConfig;
     /** Sistem promptu */
     systemPrompt?: string;
     /** Bağlam boyutu */
@@ -79,6 +114,8 @@ export type ToolHandler<Params = any> = (params: Params, ctx: ToolExecutionConte
 export type ToolExecutionSignal = {
     /** task_complete aracı çağrıldığında true olur */
     taskCompleted?: boolean;
+    /** task_complete(continue:true) çağrıldığında model yeni bir tur istemiştir */
+    continueRequested?: boolean;
 };
 export type ToolExecutionContext = {
     cwd: string;

package/dist/core/agent.d.ts

@@ -51,7 +51,7 @@ export declare class AjanAgent {
         modelPath: string;
         modelId: string;
     };
-    /** TUI göstergesi için bağlam doluluk bilgisi */
+    /** VSCode durum göstergesi için bağlam doluluk bilgisi */
     getContextStats(): {
         usedTokens: number;
         contextSize: number;

package/dist/core/agent.js

@@ -45,15 +45,30 @@ export class AjanAgent {
         this.modelPath = options.modelPath ?? resolveModelFilePath(this.model);
         // Sistem promptu her açılışta güncel çalışma diziniyle taze üretilir;
         // config.systemPrompt yok sayılır (bayat cwd içermesin diye).
+        // Modelin özel system promptu varsa onu kullan, yoksa varsayılanı üret.
+        const modelSystemPrompt = this.model.systemPrompt;
+        const modelSecondaryPrompt = this.model.secondarySystemPrompt;
+        let basePrompt;
+        if (modelSystemPrompt) {
+            // Model özel system prompta çalışma dizinini ekle
+            basePrompt =
+                modelSystemPrompt +
+                    `\n- Çalışma dizini: ${process.cwd()}. Dosya yollarında göreli yol kullan (örn. src/index.ts).\n` +
+                    `- Deneme/test alanın: ${process.cwd()}/.ajan. Deneme, prototip ve riskli testleri burada yap (open_playground); asıl projeye ancak doğruladıktan sonra uygula.`;
+        }
+        else {
+            basePrompt = buildDefaultSystemPrompt(process.cwd());
+        }
         this.systemPrompt =
-            (options.systemPrompt ?? buildDefaultSystemPrompt(process.cwd())) +
+            basePrompt +
+                (modelSecondaryPrompt ? "\n\n" + modelSecondaryPrompt : "") +
                 loadProjectContext(process.cwd());
         this.tools = options.tools ?? createCoreTools({ cwd: process.cwd(), config });
     }
     get engineInfo() {
         return { modelPath: this.modelPath, modelId: this.model.id };
     }
-    /** TUI göstergesi için bağlam doluluk bilgisi */
+    /** VSCode durum göstergesi için bağlam doluluk bilgisi */
     getContextStats() {
         if (!this.engine)
             return null;
@@ -131,7 +146,11 @@ export class AjanAgent {
                 signal: activeSignal
             });
         };
-        const continuePrompt = "Devam et. Görevin kalan adımlarını araçlarla tamamla; her şey bitip doğrulanınca task_complete aracını raporla çağır.";
+        const continuePrompt = "Devam et. (Bir önceki turda task_complete ile continue:true istedin veya işin yarıda kaldı.) " +
+            "Kalan adımları araçlarla tamamla. Görevi sürdürmek istersen yine task_complete(continue:true) çağır; " +
+            "her şey bitip doğrulandığında task_complete(continue:false) ile bitir.";
+        // Model kendi kararıyla sürdürür/durur: task_complete(continue:true) yeni tur açar,
+        // task_complete(continue:false) veya araçsız son yanıt akışı bitirir.
         let step = 0;
         let response = "";
         while (step < maxSteps) {
@@ -147,7 +166,9 @@ export class AjanAgent {
             }
             if (signals.taskCompleted)
                 break;
-            if (toolCallsThisRound === 0)
+            const keepGoing = signals.continueRequested === true || toolCallsThisRound > 0;
+            signals.continueRequested = false;
+            if (!keepGoing)
                 break;
         }
         const budgetExhausted = !signals.taskCompleted && step >= maxSteps;

package/dist/discord/presence.d.ts

@@ -0,0 +1,65 @@
+import type { DiscordConfig } from "../config/types.js";
+export type PresencePhase = "idle" | "chat" | "thinking" | "loading" | "error";
+/**
+ * AJAN etkinliklerini Discord Rich Presence'a (profildeki "Oynuyor" alanı)
+ * dönüştürür. Discord masaüstü uygulaması çalışıyorken IPC üzerinden bağlanır.
+ *
+ * Kullanım: config.json içinde `discord.enabled = true` ve `discord.clientId`
+ * ayarlanmalıdır. Client ID, https://discord.com/developers/applications
+ * adresinden alınır; görseller Rich Presence > Art Assets sekmesine yüklenir.
+ */
+export declare class DiscordPresence {
+    private client;
+    private config;
+    private readonly phaseTime;
+    private sessionStartedAt;
+    private sessionTitle;
+    private currentTool;
+    private currentStep;
+    private maxSteps;
+    private lastError;
+    private thinkingText;
+    private lastToolCallAt;
+    private loadingPercent;
+    private partyId;
+    private joinSecret;
+    private spectateSecret;
+    private connected;
+    private disposed;
+    private reconnectTimer;
+    private heartbeat;
+    private reconnectAttempt;
+    private refreshTimer;
+    private lastErrorLogAt;
+    private lastErrorLogMsg;
+    constructor(config: DiscordConfig);
+    get isEnabled(): boolean;
+    get isConnected(): boolean;
+    /** Discord IPC'ye bağlanır; başarısız olursa sessizce devam eder. */
+    connect(): Promise<boolean>;
+    disconnect(): Promise<void>;
+    /** Bağlantı koptuğunda üstel gecikmeyle yeniden bağlanmayı dener. */
+    private reconnect;
+    /** Activity'yi Discord ile canlı tutmak için düzenli tazeleme. */
+    private startHeartbeat;
+    private stopTimers;
+    onSessionStart(title: string): void;
+    onSessionEnd(): void;
+    onThinking(text: string): void;
+    onToolCall(name: string): void;
+    onToolResult(): void;
+    onStepStart(step: number, maxSteps: number): void;
+    onComplete(): void;
+    onError(message: string): void;
+    onModelLoadProgress(pct: number): void;
+    onModelLoadComplete(): void;
+    onTextChunk(text: string): void;
+    private markPhase;
+    private buildActivity;
+    /** Son durum değişikliğini 250ms'de bir tek sefere birleştirir (fırtına önleyici). */
+    private scheduleRefresh;
+    /** Aktiviteyi Discord'a gönderir; hata durumunu (tekrarı kısıtlanmış şekilde) yutar. */
+    private flushRefresh;
+    /** Açık oturum yokken "boşta" durumunu göster. */
+    showIdle(): Promise<void>;
+}