Dinleyici ve asks_wait

Dinleyici, biri artifact'ta ajana soru sorduğunda ajanı uyandırır. Tek başına çalışırken gerekmez; bir artifact'ı paylaştığında ya da ajanın ulaşılabilir kalmasını istediğinde başlat.

Dinleyiciyi başlatmak

Ajandan artifact'larındaki soruları dinlemesini iste. Ajan her oturumda bir kez, kendi harness'ıyla get_listener çağırır: claude-code, codex, copilot, antigravity ya da generic. Sonuçta şunlar gelir:

• dinleyici betiğinin adresi ve SHA-256 sağlama toplamı (ajan betiği çalıştırmadan önce bunu doğrular);
• o harness için kurulum komutu;
• arka plan süreci çalıştırılamıyorsa kullanılacak yedek yol.

Dinleyici betiği Node.js 22 ya da daha yeni bir sürüm ister.

ids verilmezse dinleyici, sahibi olduğun ya da yorumcu ve üstü rolle katıldığın artifact'lardan en son güncellenen 200 tanesini kapsar ve bu listeyi 60 saniyede bir yeniler; yeni artifact'lar kendiliğinden eklenir.

Dinleyici anahtarı

Her get_listener çağrısı yeni bir dinleme anahtarı üretir ve başlatma komutuna koyar. Bu anahtar dinleyebilir ama hiçbir aracı çağıramaz. Ajanlar onu ekrana yazmaz, kimseyle paylaşmaz. Bir token'ın yalnızca en yeni beş dinleme anahtarı etkin kalır; token iptal edilince onlar da iptal edilir.

Ajanlar nasıl uyanır?

• Claude Code dinleyiciyi arka planda --once ile çalıştırır: soru gelince komut biter, ajan soruları asks_list ile okuyup yanıtlar ve komutu yeniden başlatır.
• Codex, Copilot CLI ve Antigravity dinleyiciyi arka plandaki bir terminalde --follow ile çalıştırır; sorular ~/.blink/inbox.jsonl dosyasına eklenir, ajan her turda --drain ile okunmamışları okur.
• generic, istemci arka planda süreç tutabiliyorsa --follow kullanır; tutamıyorsa komutu sen kendi terminalinde çalıştırırsın.

Veritabanı ve belge değişiklikleri

Dinleyici değişikliklerde de ajanı uyandırabilir. İkisi de varsayılan olarak kapalıdır:

• db koleksiyonları: get_listener'a ids ile birlikte db ver. Bu koleksiyonlardaki satırlar değişince ajan uyanır ve onları db_query ile okur.
• belge değişiklikleri: get_listener bunu kurmaz. Dinleyicinin başlatma komutuna --changes <id,id> seçeneğini kendin ekle; --ids kullanıyorsan bu artifact'lar --ids içinde de olmalı. Ardından insanlar bir süre düzenlemeyi bırakınca ajan uyanır, changes_since ve read_file çağırır.

asks_wait

Arka plan süreci çalıştıramayan ya da onunla uyandırılamayan ajanlar asks_wait ile döngü içinde bekleyebilir:

after'dan yeni açık bir soru varsa hemen döner; yoksa bekler ve süre dolunca boş liste döndürür. Dönen cursor değerini bir sonraki çağrıda after olarak ver. Ajan asks_wait ile beklerken @ menüsünde dinliyor olarak görünür.