Struct ChannelIngestCapability 

pub struct ChannelIngestCapability { /* private fields */ }

Factory for creating pack instances registered via inventory at link time. Each pack crate submits a &'static dyn PackFactory wrapped in a PackRegistration; the binary’s linker collects them all into a single slice iterable at runtime.

Implementors must be Send + Sync + 'static because the registry is built once and shared across async tasks. Possession-bounded capability for the trusted channel-ingest note path.

Constructible only inside khive-runtime (the field is private), and granted during pack registration exclusively to factories named in CHANNEL_INGEST_CAPABLE_PACKS. Every call to crate::KhiveRuntime::try_create_note_as_trusted_ingest must present a reference to one, so the set of callers able to establish transport-owned message properties is bounded by possession at the composition root, not by a documentation prohibition. Two ways to obtain one: registering through PackRegistry::register_packs/register_packs_with_runtimes under the comm name (the allowlisted, automatic path), or a composition root that builds packs directly calling ChannelIngestCapability::grant_for_direct_composition and passing the result to crate::PackRuntime::accept_channel_ingest_capability (or a pack’s constructor variant that does so) itself. The residual trust assumption is unchanged either way: whoever assembles the VerbRegistryBuilder already decides which packs are wired in and already holds a KhiveRuntime, so minting the grant explicitly carries no more privilege than that composition already had by choosing to register comm at all.

Implementations

impl ChannelIngestCapability

pub fn grant_for_direct_composition() -> Self

Mint a capability for a composition root that constructs channel-transport packs directly, bypassing PackRegistry::register_packs (which grants this automatically).

See the type-level doc for the trust argument: this carries no more privilege than the caller already has by virtue of holding a KhiveRuntime and choosing to wire the pack in.