Pi kodlama ajanı 1.0'a ulaştı, deneysel Pi Durable ajan framework'ü de yanında geldi

Earendil ve Pi topluluğu Pi 1.0'ı yayınladı ve kodlama ajanını hareketli bir hedef değil, inşa için oturmuş bir temel olarak sundu. Yanında deneysel bir paket olan Pi Durable da geldi; uzun süreler boyunca çalışan, arızalar sırasında çalışmaya devam eden ve ihtiyaçlar değiştikçe yeniden şekillendirilebilen ajanlara yönelik bir framework.

Sürümü duyuran ve 1 Ekim'de Hacker News ana sayfasında öne çıkan Earendil blog yazısına göre Pi 1.0 özgün kapsamını koruyor: bir terminalde yaşayan, tek bir kişi tarafından yönetilen ve yerel ya da uzak bir makinede çalışan bir kodlama ajanı. Süreç ölürse operatür ne olduğunu inceler ve devam etmesini söyler. Pi Durable ise farklı bir ihtiyaç setine cevap veriyor — çeşitli altyapılarda çalışan, birden fazla yüzeyden ve birden fazla kişiden girdi kabul eden, sınırsız uzunlukta sohbetler yürüten ve süreç içindeki ve dışındaki arızalardan kurtulan ajanlar. Kodlama ajanının yerini almıyor; her türden agentik uygulama inşa etmek için bir framework ve pi-ai gibi kodun yanı sıra ana projenin tasarım ilkelerini paylaşıyor.

Tanımlanmış bir harness

Yazı, Pi Durable'ı bir "harness" olarak çerçeveliyor: kalıcı depolama ile bir veya birçok model sohbetini paralel yürütmek için gereken mekanizmanın birleşimi; modellerin çağırdığı araçları ve bu araçların çalıştığı ortamları sağlıyor. Bir sohbet, bir insan ile bir ajan arasındaki kayıtlı bir transkript; ajan ise bir model artı onun ayarları ve araç takımı. Araçlar bir yürütme ortamında çalışıyor — bir dizüstü bilgisayar, uzak bir VM ya da bellek içi bir sandbox — ve bir model çağrısından bir araç çağrısına kadar her iş birimi bir görev olarak ele alınıyor.

Tasarım, bütünün bir ajanın kendisinin okuyabileceği kadar küçük tutulmasını hedefliyor. Earendil, testler hariç kaynak kodun kabaca 15.000 satır olduğunu — bir GPT modeline verildiğinde yaklaşık 150.000 token, Claude ile yaklaşık 250.000 token ettiğini — ve inşa edenlerin genellikle depolama backend'lerini oluşturan 3.000 satırı atlayabileceğini belirtiyor.

JavaScript'in çalıştığı her yerde çalışacak şekilde tasarlandı

Bir harness bir depolama backend'i üzerinde açılır ve Pi Durable üç taneyle geliyor: memory, SQLite ve JSONL; ayrıca bir key-value store ya da Postgres gibi bir şeyin üzerine kendi backend'inizi yazmak için bir uyumluluk testi seti ve benchmark'lar. SQLite ve JSONL kodu Node'a özgü API'lerden kaçınıyor, böylece küçük bir adapter'la Bun üzerinde ya da bir Cloudflare Durable Object içinde çalışıyor. Belirli bir depolamayı aynı anda tek bir süreç sahiplenir ve diğer istemciler o sürece bağlanır.

SQLite'ta bellek kullanımı sınırlı kalıyor: yalnızca çalışan küme — aktif transkriptler, canlı görevler ve bekleyen submission'lar — bellekte tutulur, gerisi gerekene kadar diskte bekler. Compaction, eski mesajları modelin context window'unu taşmadan önce özetliyor; böylece binlerce mesaja uzanan transkriptler bellekte yönetilebilir kalıyor.

Yürütme ortamları da aynı küçük arayüz örüntüsünü izliyor. Varsayılan olarak bir Node ortamı geliyor; araçlara yerel dosyalara ve bir shell'e erişim veriyor, ancak özel ortamlar eklemek kolay — böylece bir makinedeki harness, başka bir yerde yürüten araçları sürebilir ve her sohbet kendi çalışma dizinine işaret eder.

Checkpoint'ler, kurtarma ve tam bir kez çalışma

Dayanıklılık checkpoint'ten geliyor: bir çalışmanın her adımı, bir sonraki başlamadan önce bir checkpoint yazıyor. Süreç ölürse — dizüstü uyku moduna geçerse, bir container yeniden dağıtılırsa, bir makinenin belleği tükenirse — yeni bir süreç aynı depolamayı açar, yarım kalan görevleri bulur ve her birini son checkpoint'inden sürdürür. Yarım kalan bir model isteği tekrar gönderilir ve transkriptte bırakılan kısmi yanıt iptal edilmiş olarak işaretlenir; kesilen bir araç çağrısı yalnızca güvenli olduğunda yeniden çalışır, aksi halde modele kesildiği söylenir.

Subagent'lar yerleşik değil, ancak yazıya göre birkaç satır kodla kurulabiliyorlar; çünkü bir subagent kendi başına bir sohbet olarak çalışıyor ve aynı kurtarma davranışını miras alıyor. Submission'lar ayrıca onları tam bir kez yapılan bir requestId taşıyor: bir çökmenin ardından tekrar deneyen istemci, isteği ikinci kez tetiklemek yerine orijinal submission'ın yanıtını alıyor.

Birçok sohbet, herhangi bir noktadan fork edilebilir

Tek bir harness, aynı garantilerle gerektiği kadar sohbeti eşzamanlı yürütür. Bir sohbet, başka bir sohbetin transkriptindeki herhangi bir noktada fork edebilir ve forktan önce ebeveynin kaydettiği her şeye, onu çoğaltmadan erişim kazanır. Yazı bir Slack benzetmesi sunuyor: bir kanal bir sohbete, bir thread de onun bir fork'una karşılık gelir.

Neden önemli

1.0 etiketi, Pi'nin çekirdek tek kullanıcılı, terminal tabanlı deneyiminin artık stabil kabul edildiğine işaret ediyor; bu da üzerine inşa eden herkes için önemli. Daha ilginç hamle Pi Durable: Pi'nin minimalist felsefesini — ajanın kendisinin kavrayıp değiştirebileceği kadar küçük bir kod tabanı — dayanıklı, çok yüzlü, uzun süreli ajanların daha zor problemine uyguluyor. Earendil, Pi Durable üzerinde agentik uygulamalar inşa ederken öğrenilen derslerin değerli oldukları kanıtlandıkça kodlama ajanına geri akacağını açıkça belirtiyor ve paket, topluluğun geliştirmeye yardım etmesi için açık bir davetle deneysel olarak çerçeveleniyor. Ajan-harness alanını izleyen geliştiriciler için bu, dayanıklılık ve biçimlendirilebilirliğin büyük bir platformda değil, küçük ve incelenebilir bir kod tabanında bir arada var olabileceğine dair kayda değer bir bahistir.