Cloudflare Worker önizlemesi

Uyumluluk: Pactmark 0.2.x. Durum: deneysel. Burada anlatılan staging sonucu anonim, geçici, bellek destekli ve açıkça üretim dışıdır.

`@pactmark/cloudflare` nedir

Web standardı bir HTTP alt kümesi. Var olma amacı, çekirdeğin gerçekten taşınabilir olduğunu — core, runtime, policy, evidence ve agent’ın Node yerleşiklerinden, ortam okumalarından ve sağlayıcı SDK’larından kaçındığını — kanıtlamaktır; önerilen bir üretim hedefi olmak değil.

src/index.ts

import { createWorkerFetchHandler } from "@pactmark/cloudflare";

const handler = createWorkerFetchHandler({
  basePath: "/v1",
  runtime,
  authenticate: async (request, env) => resolvePrincipal(request, env),
});

export default {
  async fetch(request: Request, env: Env, ctx: ExecutionContext) {
    return handler(request, { env, signal: request.signal, waitUntil: ctx.waitUntil.bind(ctx) });
  },
};

Staging kontrolü gerçekte neyi tesis etti

Sağlık 200 döndü

Worker başladı ve sağlık uç noktasını sundu.

Tek deterministik SSE fixture'ı tamamlandı

Web standardı işleyici üzerinden akış çalışıyor.

Hata yönlendirmesi doğru davrandı

Kararlı KAF_* kodlarıyla Problem Details yanıtları.

Hazırlık dürüstçe 503 döndü

Çünkü bellek destekli çalışma zamanı ne kalıcı ne de üretim-izoledir. Sayfadaki en önemli sonuç budur.

Ayrıca tip üretimi ve bir Wrangler dry-run kontrolünden geçti.

Anonim, geçici hiçbir fixture’a sır veya müşteri verisi göndermeyin. Genel staging URL’si ve tam dağıtım kanıtı, depodaki değişken v0.1 hazırlık kaydında bulunur.

Bir Worker içinde yapamayacaklarınız

Desteklenmeyen yetenek meta verisi bozularak değil kapalı biçimde başarısız olur. Özellikle şunları seçmeyin:

Kullanılamaz	Nedeni
Node’a özgü yürütücüler	Workers çalışma zamanı Node değildir
stdio MCP	Yerel süreç modeli yok
Yerel dosya sistemi varsayımları	Dosya sistemi yok
Postgres worker sürücüsü	Fenced kira döngüsü için uzun ömürlü süreç yok

Platform tarafından desteklenen kalıcılık ve egress adaptörlerini açıkça sağlamalısınız. Sessizce yanlış şeyi yapan bir varsayılan yoktur.

Ajanınızın neye ihtiyacı olduğunu beyan etmek

export const portableAgent = defineAgent({
  // …
  requiredRuntimeCapabilities: ["streaming", "cancellation"],
});

Çalışma zamanı gereken bir yeteneği sağlayamıyorsa, koşu başlamadan önce KAF_RUNTIME_CAPABILITY_MISSING üretilir. backgroundWakeup veya durableStorage gerektiren bir ajan, bunlar olmadan yapılandırılmış bir Worker’da çalışmayı reddeder — ki doğru sonuç budur.

Bu hedef ne zaman mantıklı

Taşınabilirlik testi

Ajan kodunuzun kazara bir Node bağımlılığı edinmediğini kanıtlamak.

Salt okunur, kısa, kendine yeten koşular

Koşunun tamamının gerçekten tek bir istek içinde bittiği ve hiçbir dış etkiye neden olmadığı durumlar.

Edge'e bakan bir cephe

Başka yerde yaşayan kalıcı bir Pactmark dağıtımının önünde. Worker TLS’i sonlandırır ve iletir; koşuya sahip olmaz.

Ne zaman değil

Bir insanı bekleyen, dış etkiye neden olan, mutabakat gerektiren veya süreç yeniden başlatmasından sağ çıkması gereken her koşu. Bunlar kalıcı profili gerektirir — bkz. Node ve OCI konteyneri.

Portable agent örneği

Node, Vercel ve Cloudflare giriş noktalarının arkasında değiştirilmemiş tek bir uygulama.

Pactmark neyi kanıtlamaz

Bu deneysel durumun diğer sınırlar arasındaki yeri.

Başlarken

Temel kavramlar

Rehberler

Dağıtım

Üretim

Güvenlik

Cloudflare Worker önizlemesi

`@pactmark/cloudflare` nedir

Staging kontrolü gerçekte neyi tesis etti

Sağlık 200 döndü

Tek deterministik SSE fixture'ı tamamlandı

Hata yönlendirmesi doğru davrandı

Hazırlık dürüstçe 503 döndü

Bir Worker içinde yapamayacaklarınız

Ajanınızın neye ihtiyacı olduğunu beyan etmek

Bu hedef ne zaman mantıklı

Ne zaman değil

Portable agent örneği

Pactmark neyi kanıtlamaz

​@pactmark/cloudflare nedir

​Staging kontrolü gerçekte neyi tesis etti

Sağlık 200 döndü

Tek deterministik SSE fixture'ı tamamlandı

Hata yönlendirmesi doğru davrandı

Hazırlık dürüstçe 503 döndü

​Bir Worker içinde yapamayacaklarınız

​Ajanınızın neye ihtiyacı olduğunu beyan etmek

​Bu hedef ne zaman mantıklı

​Ne zaman değil

Portable agent örneği

Pactmark neyi kanıtlamaz

`@pactmark/cloudflare` nedir

Staging kontrolü gerçekte neyi tesis etti

Bir Worker içinde yapamayacaklarınız

Ajanınızın neye ihtiyacı olduğunu beyan etmek

Bu hedef ne zaman mantıklı

Ne zaman değil