Yönetici Özeti ve Mimari Önemi
vercel-sandbox-commands-now-supp sürümü, Vercel Sandbox mimarisi için kritik bir evrimsel dönüm noktasıdır. Tarihsel olarak, bulut sandbox'larındaki yürütme ortamları öncelikle 'çalıştır ve unut' veya istek-yanıt paradigması üzerinde çalışmış, bu da uzun süren süreçlerle gerçek zamanlı, çift yönlü etkileşimi son derece zorlaştırmıştır. Yerel Standart Giriş (stdin) desteğinin sunulmasıyla Vercel, durumsuz sunucusuz (serverless) çalışma zamanları ile durum bilgisi tutan (stateful) etkileşimli komut satırı arayüzleri arasındaki mimari boşluğu kapatmıştır. Bu yetenek, geliştiricilerin mikro ajanları, Model Bağlam Protokolü (MCP) sunucularını ve karmaşık veri boru hattı işlemlerini doğrudan izole bulut iş yükleri içinde nasıl koordine edebileceğini kökten dönüştürmektedir.
Kurumsal altyapı perspektifinden bakıldığında, bu güncelleme yapay zeka odaklı geliştirme ve otomatik testlerde gelişmiş kalıpların kilidini açmaktadır. Geliştiriciler artık kalıcı sanal makineler tedarik etmeden agent-browser MCP sunucusu gibi özel ajanları ayağa kaldırabilir ve programatik olarak dinamik girdiler besleyebilir, durumu müzakere edebilir ve gerçek zamanlı stdout/stderr akışlarını ayrıştırabilir. Bu optimizasyon, altyapı yükünü önemli ölçüde azaltırken sunucusuz bilişimin yürütme sınırlarını büyük ölçüde genişletmektedir. Mimari dayanıklılık, katı izolasyon parametreleriyle sürdürülmekte ve etkileşimli komut akışının sandbox sınırlarını tehlikeye atmasını veya kiracı yürütmeleri genelinde bellek sızıntısı vektörleri oluşturmasını engellemektedir.
Çekirdek Geliştirmeler ve Geliştirici Ergonomisi
Bu sürümün ayırt edici özelliği, hem TypeScript hem de Python SDK'larında stdin akışının sorunsuz bir şekilde entegre edilmesidir. TypeScript ekosisteminde geliştiriciler, temel süreç yürütme katmanı içinde stdin: true ve detached: true parametrelerini yapılandırarak etkileşimli oturumlar başlatabilirler. Etkileşim, özel ilkel öğeler aracılığıyla açıkça yönetilir: writeStdin() etkin yükleri çalışan süreç arabelleğine iterken, closeStdin(), komut alımını zarif bir şekilde sonlandırmak için dosya sonu (EOF) koşulunu bildirir. Ek olarak SDK, process.stdin gibi Node.js okunabilir akışlarının yerel olarak boru hattına (pipe) aktarılmasını destekler; böylece manuel arabellek yönetim yönetimine gerek kalmadan yerel CLI sarmalayıcıları (wrappers) ve gerçek zamanlı olay yayıcıları ile zahmetsiz entegrasyon sağlanır.
Python ortamları için eşdeğerlik, stdin=subprocess.PIPE kullanan standart kütüphane uyumu ile elde edilir. Geliştiriciler server.stdin.send() kullanarak programatik olarak yükler gönderebilir ve stdin kapanmasını, kalan arabellek toplamasını ve süreç çıkış durumu toplamasını koordine eden communicate() kullanarak yürütme döngülerini sonlandırabilir. Girdinin önceden çözülebileceği akıcı yükler için Python SDK, doğrudan run_process() içinde bir input parametresi kabul eder. Bu ergonomik geliştirmeler ortak kodları (boilerplate) ortadan kaldırır, asenkron olay döngülerini kolaylaştırır ve mühendislik ekibi tarafından seçilen altyazı çalışma zamanından bağımsız olarak tek tip soyutlamalar sağlar.
Mimari Karşılaştırma Matrisi
| Değerlendirme Metriği | Önceki Sandbox Taban Çizgisi (vercel-sandbox) |
Güncellenen Sürüm (vercel-sandbox-commands-now-supp) |
|---|---|---|
| Etkileşimli Gecikme | Yüksek (Çok turlu veriler için yoklama veya süreç yeniden başlatmaları gerektirir) | Ultra Düşük (Stdin/stdout aracılığıyla doğrudan gerçek zamanlı akış) |
| Bellek Kaplaması | Tek seferlik çağrı başına statik tahsis | Akış verileri için optimize edilmiş dinamik arabellek yönetimi |
| API Soyutlaması | Durumsuz çalıştır ve unut komut yürütme | Durum bilgisi tutan çift yönlü akışlar (writeStdin, communicate) |
| MCP Sunucu Desteği | Sınırlı (Etkileşimli stdio MCP kalıplarıyla uyumsuz) | Yerel (Stdio tabanlı Model Bağlam Protokolü için tam destek) |
Sonlandırılan Değişiklikler ve Geçiş Uyarıları
Önceki sürümlerle tamamen geriye dönük uyumludur. Mevcut sandbox dağıtımları, tek seferlik komut çağrıları ve etkileşimli olmayan betikler herhangi bir değişiklik olmaksızın çalışmaya devam edecektir. Stdin yönetimi ve süreç ayırma katmanlarının tanıtılması SDK arayüzlerine eklenen uzantılar olduğundan, hiçbir eski yöntem kullanım dışı bırakılmamış veya kaldırılmamıştır. Bununla birlikte, detached: true ve akış girdilerini benimseyen ekipler, uygun yaşam döngüsü yönetimini uygulamalıdır - özellikle konteyner sınırları içinde askıda kalan süreçleri ve zombi iş parçacığı birikimini önlemek için closeStdin() veya communicate() öğesinin açıkça çağrılmasını sağlamalıdır.
Adım Adım Yükseltme Kılavuzu
Etkileşimli sandbox komutlarından yararlanmak için yükseltme yapmak, SDK bağımlılıklarınızı güncellemenizi ve uygun akış parametrelerini yapılandırmanızı gerektirir.
SDK Bağımlılıklarınızı Güncelleyin: Projenizin TypeScript veya Python için Vercel Sandbox SDK'nın en son sürümünü kullandığından emin olun.
TypeScript Yürütme Bağlamını Yapılandırın: Ayrıştırılmış yürütme ve standart girdi borulamasını etkinleştirmek için gerekli bayrakları geçirin:
const result = await runCommand('node mcp-server.js', { stdin: true, detached: true }); // Gerçek zamanlı talimatlar gönderin await writeStdin(result, JSON.stringify({ action: 'initialize' })); // Girdi akışını sonlandırın await closeStdin(result);Python Boru Hattı Mantığını Uygulayın: Python ortamları için alt süreç borularından (subprocess pipes) ve akış işleyicilerinden yararlanın:
process = run_process('python agent.py', stdin=subprocess.PIPE) process.stdin.send(b'{"query": "analyze code"}') output, error = process.communicate()