Uyumluluk: Pactmark 0.2.x. Tam iç paket sürümleri v0.1 hattı için tek bir yayın sürümünü
paylaşır.
create-pactmark dışındaki her paket @pactmark kapsamında yayımlanır.Taşınabilir çekirdek
Sağlayıcıdan bağımsız alan
Şemalar, portlar, olaylar, yetki tipleri, kanonik JSON ve özetler ile kararlı
KAF_* hata kaydı.
Zod’a bağımlıdır, başka hiçbir şeye değil.Koşu orkestrasyon çekirdeği
Koşuları
core’da tanımlı portlar üzerinden yürütür. Geçişlere, adım yürütmesine, yeniden deneme
sınıflandırmasına ve etki defteri etkileşimine sahiptir.Varsayılan-ret kararlar
Admission, kanonikleştirme, yetkilendirme rezervasyonları, etki stratejileri, grantlar, kill
switch’ler, politika değerlendirmesi, sebep kodları ve sır işleme.
Artifact'lar, doğrulama, kanıt
İçerik-adresli artifact’lar, doğrulama bağlama, kanıt dışa aktarımı, redaksiyon ve desen olgunluğu.
Yazım yüzeyi
Çoğu uygulamanın içe aktardığı paket.
defineAgent, defineTool, definePolicy,
defineInstructions, createRuntime, createLocalRuntime, createLocalAuthorityIssuer,
evaluateRuntimeReadiness ve yazım için gereken core parçalarının yeniden dışa aktarımları.Yürütme ve test
Beyan edilmiş araç yürütmesi
createDeclaredToolExecutor ve createDenyAllEgressBroker gibi kapalı-başarısızlık egress aracıları.Deterministik sahteler ve sözleşme paketleri
FakeClock, SequenceIdGenerator, FakeModelDriver, FakeTool, FakeToolExecutor,
CrashInjector, crashAtEveryBoundary, ScenarioBuilder, depo sözleşme paketleri ve sözleşme
fixture’ları. Asla üretim dışa aktarımının parçası değildir.Depolama ve worker’lar
Yalnızca geliştirme
Deterministik, tenant kapsamlı, geçici depolar. Testler için mükemmel; üretim için diskalifiye ve
hazırlık kontrolü bunu söyler.
Kalıcı depolar
Tenant kapsamlı PostgreSQL depoları. Postgres sürücüsü buraya aittir ve
core, runtime, agent
veya CLI üretim kodu tarafından asla içe aktarılmaz.Fenced worker döngüsü
Veritabanı-zamanlı kiralar ve fencing token’larıyla kalıcı uyandırma sahiplenmesi.
Taşıma ve protokol
Web standardı HTTP adaptörü
createAgentFetchHandler ve createOpenApiDocument. Başlatma, devam, inceleme, olaylar, girdi,
kararlar, mutabakat, telafi, iptal, sağlık ve hazırlığı uygular.node:http köprüsü
createPactmarkNodeServer, createNodeRequestListener, closeNodeServer,
installGracefulShutdown. Yanıtları akıtır ve istemci kopmalarını AbortSignal olarak yayar.Next.js rota adaptörü
createVercelRouteHandler. HTTP işleyicisinin üzerinde, istek-zamanı ortamını, sinyali, waitUntil
ve yetenekleri sağlayan ince bir sarmalayıcı.Deneysel Worker alt kümesi
Workers çalışma zamanı için Web standardı işleyici. Yalnızca taşınabilir çekirdek; Node’a özgü
yetenekler kapalı biçimde başarısız olur.
Korumalı MCP istemcisi
Test edilmiş stdio ve Streamable HTTP taşımaları. Sunucu meta verisi ve çıktısı güvenilmez sayılır;
keşif asla yetki vermez.
Entegrasyon ve araçlar
Vercel AI SDK adaptörü
İsteğe bağlı peer entegrasyon. Desteklenen model çağrılarını normalize ederken politika ve araçların
sahipliği Pactmark çalışma zamanında kalır.
İsteğe bağlı meta veri telemetrisi
İsteğe bağlı peer olarak OpenTelemetry API. Varsayılan olarak yalnızca meta veri; uzak dışa aktarım
varsayılan olarak kapalı.
pactmark ikili dosyası
Enjekte edilmiş host adaptörleri üzerinden run, inspect, doctor, eval, evidence, migrate, mutabakat ve
telafi yüzeyleri.
Deterministik çevrimdışı başlatıcı
Her dosyayı bir özetle planlar, planı yazdırır, sonra yazar. Şablonlar:
vercel-next, node-server,
cloudflare-worker, library.Bağımlılık kuralı
Sağlayıcı istemcileri tüketen uygulamalara ya da ilgili adaptöre peer/isteğe bağlı bağımlılık olarak aittir.Tipik içe aktarma kümeleri
Agent API
@pactmark/agent yüzeyinin tamamı.Mimari
Katmanlamanın neden böyle olduğu.