boson-core

Shared types, QueueBackend trait, router, errors, and identity hooks.

Task authors usually start at boson. This crate holds shared DTOs and the persistence trait for Developing the backend.

Role

• Job, Run, TaskConfig, status enums — shared data (Creating tasks / admin)
• ExecutionContext / ExecutionContextFactory — handler identity (Creating tasks in handlers; factory installed at boot)
• QueueBackend — stable async trait for queue persistence (Developing the backend)
• QueueRouter — register named backends at host boot (Integrating the server)

Third-party crates implement QueueBackend only against DTOs exported here. See QueueBackend rustdoc (How to implement, method groups, skeleton).

Identity

Task handlers take Box<dyn ExecutionContext> as the first argument. Factory choice and boot wiring live in boson-runtime and src/identity.rs.

Related crates

• boson — main crate (re-exports task, JsonExecutionContextFactory)
• boson-macros — #[boson::task] attribute macro
• boson-runtime — worker runtime built on this trait
• Root README — overview