GNL
Örnekler

Beş örnek. Hiçbiri API anahtarı istemiyor.

Depodaki her örnek deterministik bir mock modele karşı çalışıyor; yani bir sağlayıcıya tek token harcamadan klonlayıp garantinin tuttuğunu görebilirsin. Her biri arkasında gerçek doğrulamalar olan gerçek bir program — sayfada iyi duran bir parçacık değil.

Önce paketleri derle: depo kökünde pnpm -r build — workspace linkleri dist'i işaret ediyor.

examples/oncall-triage

On-call olay triyajı

Tutorial örneği — tüm paketler, tek gerçek iş: production'ı iki kez yeniden başlatmadan olay triyajı.

Bir alarm gönderin: ajan runbook'u okur, metriği çeker, logu okur ve bir şeyi yeniden başlatmadan önce onay için durur. O logdaki veritabanı parolası modele hiç ulaşmaz. Onaylayın; yeniden başlatma tam olarak bir kez olur ve dağıtımdan sağ çıkan bir gözetim zamanlanır. Aynı alarmı yepyeni bir çalıştırma olarak tekrar ateşleyin — nöbetçi mühendis yine yalnızca bir kez sayfalanır.

Kaynağı gör
Çalıştır
examples/oncall-triage
pnpm start
http://localhost:3200 · /studio
Paketler
durableworkflowmemoryragcacheprocessorstool-schemaqueueeventsschedulera2amcpserverchat-adapterstudioauthevalsotel
examples/app

Dayanıklı yapay zekâ destek masası

Tam referans uygulama — tek port, Studio /studio altına mount edilmiş.

Bir talep aç ve iade iste: ajan politikayı RAG üzerinden arar, iade tool'unu çağırır, tutar limitin üstünde olduğu için guard onay bekletir. Onayla — iade tam bir kez işlenir, arka planda e-posta işi ve bir iade olayı tetiklenir. Sonra çalıştırmanın tamamını ops Studio'da time-travel ile yeniden oynat.

Kaynağı gör
Çalıştır
examples/app
pnpm start
http://localhost:3100 · /studio
Paketler
durablememoryragqueueeventsworkflowstudioevalsotelcacheprocessors
examples/incident-proofs

Olay kanıtları

Belgelenmiş üç çift-yan-etki hatası; önce yeniden üretiliyor, sonra engelleniyor.

Aynı tool, aynı argümanlarla, tek turda beş farklı toolCallId altında beş kez. 180 saniyeyi aşan bir tool çağrısının checkpoint'ten çökme sonrası sessizce yeniden gönderilmesi. Bir onay olayının iki kez işlenmesi. Her vaka iki kez koşuyor — korumasız, sonra GNL ile — ve iki sayım yan yana basılıyor.

Kaynağı gör
Çalıştır
examples/incident-proofs
pnpm proofs
Paketler
durable
examples/stripe-idempotency

Sağlayıcı tarafında exactly-once

Garantinin framework'ü aşıp ödeme sağlayıcısının kendisine ulaşması.

durableTool her tool çağrısına sabit bir idempotencyKey enjekte ediyor — runId:toolCallId — ve bu örnek onu bir mock Stripe istemcisine taşıyor. Korumasızken naif yeniden deneme her seferinde yeni bir anahtar üretiyor, Stripe bunun bir retry olduğunu anlayamıyor: iki tahsilat. GNL ile yeniden deneme aynı anahtarı taşıyor: tek tahsilat. recover() kancasıyla execute ikinci kez hiç çalışmıyor.

Kaynağı gör
Çalıştır
examples/stripe-idempotency
pnpm demo
Paketler
durable
examples/react-client

React sohbet istemcisi

useChat, token akışı ve tarayıcıdan interrupt onaylama.

Otomatik üretilen REST + SSE arka ucuna karşı bir Vite ön yüzü. Token'lar geldikçe akıyor; bir tool çağrısı onay için askıya alındığında interrupt arayüzde Onayla/Reddet ile beliriyor — destek masasının kullandığı aynı suspend/resume, istemci tarafından görünen hâli.

Kaynağı gör
Çalıştır
examples/react-client
pnpm server
pnpm dev
http://localhost:5173
Paketler
clientdurableserver
examples/showcase

Kendini doğrulayan showcase

Her özellik, doğrulamasıyla birlikte, geçti/kaldı olarak basılıyor.

Paketleri gerçek bir tüketicinin yaptığı gibi import ediyor ve her özelliği arkasında bir doğrulama olacak şekilde koşuyor: çökme boyunca exactly-once, PII maskeleme, reranker'lı RAG, MCP istemci ve sunucu, çok-ajanlı devir, dayanıklı kuyruk, exactly-once olay veri yolu, ağlar arası A2A, çalıştırmalar arası önbellek, evals, OTel maliyet şelalesi, time-travel ve fork. Sonunda N/N basıyor.

Kaynağı gör
Çalıştır
examples/showcase
pnpm demo
pnpm studio
http://localhost:4321
Paketler
durableragmcpa2amemoryqueueeventsworkflowserverstudioevalsotelcacheprocessors

Her garantinin nasıl çalıştığını oku, sonra çalıştır.

Yukarıdaki her örnek dokümanlardaki bir özellik sayfasına karşılık geliyor — çağırdığı API, dayandığı garanti ve resume'da ne olduğu.