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ı

Ç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.
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.