Struct OrchestratorBuilder 

pub struct OrchestratorBuilder { /* private fields */ }

Collects everything one Orchestrator needs.

Implementations

impl OrchestratorBuilder

pub fn new() -> Self

An empty builder with the conservative configuration.

pub fn workflows(self, workflows: Arc<WorkflowRegistry>) -> Self

The workflows this runtime hosts.

pub fn providers(self, providers: Arc<ProviderPool>) -> Self

The configured providers.

pub fn stores(self, stores: Stores) -> Self

The persistence layer.

pub fn consequences(self, consequences: Arc<dyn TurnConsequences>) -> Self

Declares what a turn’s writes imply on other cases. See TurnConsequences.

pub fn case_directory(self, directory: Arc<dyn CaseDirectory>) -> Self

The directory of addressable cases.

pub fn knowledge(self, knowledge: Arc<dyn KnowledgeProvider>) -> Self

The knowledge provider answers may rest on (spec §19.2).

pub fn attachments(self, source: Arc<dyn AttachmentSource>) -> Self

Where the bytes of the turn’s files come from. Without one, no model is shown a file.

pub fn policy(self, policy: PolicySnapshot) -> Self

The policy snapshot commands are judged against (spec §14.3).

pub fn observer(self, observer: Arc<dyn Observer>) -> Self

Where metrics go (spec §26.2).

pub fn mode(self, mode: OrchestrationMode) -> Self

How much autonomy the model gets (spec §11.1). Refused beside Self::config; see BuildError::ConflictingMode.

pub fn config(self, config: OrchestratorConfig) -> Self

The whole configuration, mode included. Refused beside Self::mode.

pub fn clock(self, clock: Arc<dyn TurnClock>) -> Self

Replaces the runtime clock.

pub fn case_id_factory(self, factory: Arc<dyn CaseIdFactory>) -> Self

Replaces the factory that mints identifiers for new cases.

pub fn understander(self, understander: Arc<dyn TurnUnderstander>) -> Self

Replaces what understands each turn. The default is an Understander over the configured providers, with the profiles and settings of UnderstandingConfig.

pub fn prompt_source(self, source: Arc<dyn PromptSource>) -> Self

Lets a prompt source supply the instructions of every model task.

Without one the runtime uses the text compiled into the library. Each task asks for its own name, understand.<task> or narrate.<task>, and its record cites the prompt it ran under. It applies to the stages this builder creates.

pub fn prompt_selector(self, selector: PromptSelector) -> Self

Which version of each prompt the source is asked for. Pin one, so an edit in a registry cannot change a running system.

pub fn composer(self, composer: Composer) -> Self

Replaces the composition stage.

pub fn notice_copy(self, copy: NoticeCopy) -> Self

Replaces the notices the reducer writes itself. English by default; a deployment in another language wants this, the composer’s copy and Self::confirmation_copy.

pub fn attachment_copy(self, copy: AttachmentCopy) -> Self

Replaces what a user is told about a file the model was not shown.

pub fn locales<L: Into<Locale>>( self, locales: impl IntoIterator<Item = L>, ) -> Self

The languages this deployment serves: building fails while any of the server’s own sentences has no text in one of them. The built-in copy speaks English and Italian.

pub fn confirmation_copy(self, copy: ConfirmationCopy) -> Self

Replaces the copy on the cards the policy engine raises, the two buttons of every confirmation card included.

pub fn trace(self, trace: Arc<dyn TurnTrace>) -> Self

Reports every turn’s events to trace: for local debugging, since a trace holds the users’ words. Wrap the providers in TracedProvider to add the model calls. See crate::trace.

pub fn build(self) -> Result<Orchestrator, BuildError>

Builds the orchestrator.

Errors

BuildError::Missing for the first mandatory part not supplied, BuildError::Config for a configuration the library refuses, and BuildError::ConflictingMode.

Trait Implementations

impl Debug for OrchestratorBuilder

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

Formats the value using the given formatter.

impl Default for OrchestratorBuilder

fn default() -> Self

Returns the “default value” for a type.