Uyumluluk: Pactmark 0.2.x. Tüm paketler v0.1 hattı için tek bir sürüm numarasını paylaşır ve
paket başına provenance ile yayımlanır.
Sistemin biçimi
Şekil 1. Çekirdek yapısı gereği sağlayıcıdan bağımsızdır.core, runtime, policy,
evidence ve agent; Node yerleşiklerinden, ortam okumalarından ve sağlayıcı SDK’larından kaçınır.
Aynı ajan uygulamasının Node’da, bir Next.js rotasında ve bir Cloudflare Worker’ında çalışmasını
sağlayan da budur.
Her katman neye sahiptir
Taşınabilir çekirdek — core, runtime, policy, evidence, agent
Taşınabilir çekirdek — core, runtime, policy, evidence, agent
core alanı tutar: şemalar, portlar, olaylar, yetki tipleri ve kararlı KAF_* hata kaydı.
runtime koşuları bu portlar üzerinden yürütür. policy varsayılan-ret kararlarını, grantları,
kanonikleştirmeyi, kill switch’leri ve etki stratejilerini uygular. evidence içerik-adresli
artifact’ları, doğrulamayı, redaksiyonu ve desen olgunluğunu yönetir. agent çoğu uygulamanın içe
aktardığı ergonomik yazım yüzeyidir.Yürütme ve test — executor-in-process, testing
Yürütme ve test — executor-in-process, testing
executor-in-process beyan edilmiş araçları süreç içinde çalıştırır ve kapalı-başarısızlık egress
aracıları sağlar. testing sahte saatler, deterministik kimlikler, sahte model sürücüleri, çökme
enjeksiyonu ve yeniden kullanılabilir adaptör sözleşme paketleri sunar — ve asla üretim dışa
aktarımının parçası değildir.Depolama ve worker — store-memory, store-postgres, driver-postgres-worker
Depolama ve worker — store-memory, store-postgres, driver-postgres-worker
store-memory deterministik, tenant kapsamlı ve açıkça geçicidir. store-postgres kalıcı,
tenant kapsamlı depolar sağlar. driver-postgres-worker bir uyandırmanın tam olarak bir worker
tarafından sahiplenilmesini sağlayan fenced kira döngüsünü uygular.Taşıma ve protokol — http, node, vercel, cloudflare, mcp
Taşıma ve protokol — http, node, vercel, cloudflare, mcp
http tüm komut yüzeyi için Web standardı işleyiciler uygular. node zarif kapanışla birlikte
node:http köprüsü kurar. vercel ince bir Next.js rota adaptörüdür. cloudflare deneysel Worker
alt kümesidir. mcp, keşfedilen tüm meta veriyi güvenilmez sayan korumalı bir Model Context
Protocol istemcisidir.Entegrasyon ve araçlar — ai-sdk, otel, cli, create-pactmark
Entegrasyon ve araçlar — ai-sdk, otel, cli, create-pactmark
ai-sdk, Vercel AI SDK’yı tipleri çekirdek API’lere sızmadan uyarlar. otel isteğe bağlı,
yalnızca meta veri telemetrisi yayar. cli, pactmark ikili dosyasını enjekte edilmiş host
adaptörleri üzerinden sunar. create-pactmark deterministik çevrimdışı başlatıcıdır.Sistemi dürüst tutan bağımlılık kuralı
Çekirdek; tescilli bir model geçidine, sağlayıcı HTTP istemcisine, platform SDK’sına, dağıtım CLI’ına, telemetri dışa aktarıcısına veya barındırılmış veritabanı SDK’sına bağımlı olamaz.Bu, gözden geçirme disipliniyle değil CI’daki bağımlılık-sınırı denetimleriyle zorlanır. Pratikte: koşu semantiğinin tek satırına dokunmadan Postgres’i başka bir kalıcı depoyla veya AI SDK’yı doğrudan bir sağlayıcı istemcisiyle değiştirebilirsiniz.
Gerçekte ne içe aktarırsınız
Çoğu uygulama için cevap kısadır:Bir koşu katmanlar arasında nasıl ilerler
Şekil 2. Üçüncü sütunu “bu aşama reddettiğinde hangi paket sorumlu” sorusunun yanıtı olarak okuyun. İçindeki hiçbir şey model adaptörüne ait değildir.Pratikte taşınabilirlik
portable-agent örneği, değiştirilmemiş tek bir ajan uygulamasını Node, Vercel ve Cloudflare biçimli
giriş noktalarından çağırır; üçü de aynı deterministik fixture’ı kullanır ve normalize edilmiş bir
sözleşme sonucu döndürür.
Paket başvurusu
On dokuz paketin tamamı, dışa aktarımları ve sınırlarıyla.
Üretim veri akışı
Aynı mimari, güven sınırları ve operatör sorumluluklarıyla açıklanmış hâli.