Rust SDK overview

The facade crate, optional adapters, and the main producer/runtime types.

The headgate crate is the application-facing facade. It re-exports core envelope and outcome types, the Task derive, producer client, registry, worker, contexts, extensions, steps, scheduling, plugins, and test helpers.

[dependencies]
headgate = "0.1.10"
headgate-postgres = "0.1.10"
serde = { version = "1", features = ["derive"] }
tokio = { version = "1", features = ["rt-multi-thread", "macros"] }

Add headgate-workflow for durable DAGs, headgate-crypto for client-side encrypted payloads, headgate-otel for OpenTelemetry, or headgate-prometheus for native Prometheus metrics. These opt-in layers keep drivers and exporters out of core.

Main types

Type	Role
Client	Validated producer boundary
Envelope	Durable job and policy inputs
Task	Typed payload codec and metadata
Registry	Kind/version dispatch table
Worker	Admission, heartbeat, execution, shutdown
JobCtx	Attempt identity, logging, output, progress, steps
WorkerConfig	Queues, capacity, leases, polling, telemetry

Define tasks

Run workers