Struct PackRegistry 

pub struct PackRegistry { /* private fields */ }

Every Pack a Host’s Plugins insert, by fully qualified name, each with its Pack id and config.

The Host owns the registry; a Plugin only inserts its Packs into it, by calling insert from its install function. The Host makes the registry with new, which holds the built-ins such as runvil/subagents from the start, and calls each Plugin it links. Then it hands the registry to HostContext::new, which reads it through into_entries and calls each Pack’s construct once, at startup, to make the one Pack object every run shares.

Implementations

impl PackRegistry

pub fn new() -> PackRegistry

A registry holding only the built-ins.

pub fn insert( &mut self, info: PackInfo, config: Value, ) -> Result<(), InstallError>

Inserts info as a linked Pack with config, which its construct receives when the Host builds it.

The Pack id is the FQN’s second segment, so runvil/web is web, and the registry may hold Packs of different vendors with the same Pack id, such as runvil/web and acme/web.

Errors

Returns InstallError::InvalidFqn when the FQN is not a vendor/name pair of valid one-segment names, InstallError::DuplicatePack when the registry holds the FQN already, as it holds each built-in’s from the start, and InstallError::ReservedName when the Pack id is a built-in’s.

pub fn list(&self) -> impl Iterator<Item = (&PackInfo, PackOrigin)>

Every Pack the registry holds, built-ins included, with its origin, in FQN order.

pub fn into_entries(self) -> impl Iterator<Item = (PackInfo, PackId, Value)>

Every Pack the registry holds, built-ins included, with its Pack id and its config, in FQN order: what a Host builds its Packs from.

Trait Implementations

impl Debug for PackRegistry

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Shows each Pack’s FQN, origin, and Pack id, and never its config, which may hold a credential such as a bearer token.

impl Default for PackRegistry

fn default() -> PackRegistry

A registry holding only the built-ins.