Struct PlatformDefinition 

pub struct PlatformDefinition { /* private fields */ }

Shared definition of the Everruns platform surface.

PlatformDefinition lets an embedder decide which capabilities, LLM drivers, connection providers, built-in harness templates, and platform service factories exist at runtime. Server and worker code should consume the same definition so the control plane and execution plane stay aligned.

Example

use everruns_core::{
    BuiltInCapabilityDefinition, BuiltInHarnessDefinition, BuiltInHarnessRole,
    DriverRegistry, PlatformDefinition,
};

let mut drivers = DriverRegistry::new();
everruns_openai::register_driver(&mut drivers);

let platform = PlatformDefinition::builder()
    .driver_registry(drivers)
    .capability(everruns_core::CurrentTimeCapability)
    .add_built_in_harness(
        BuiltInHarnessDefinition::new(
            "minimal",
            "Minimal",
            "Small default harness for an embedded deployment.",
            "You are a helpful assistant.",
        )
        .with_roles([BuiltInHarnessRole::Base, BuiltInHarnessRole::Default])
        .with_capabilities([BuiltInCapabilityDefinition::new("current_time")]),
    )
    .build();

Implementations

impl PlatformDefinition

pub fn new( capability_registry: CapabilityRegistry, driver_registry: DriverRegistry, ) -> Self

Create a platform definition from explicit registries.

pub fn builder() -> PlatformDefinitionBuilder

Create a builder for fluent platform composition.

pub fn capability_registry(&self) -> &CapabilityRegistry

Immutable access to the capability registry.

pub fn capability_registry_mut(&mut self) -> &mut CapabilityRegistry

Mutable access to the capability registry.

pub fn driver_registry(&self) -> &DriverRegistry

Immutable access to the driver registry.

pub fn driver_registry_mut(&mut self) -> &mut DriverRegistry

Mutable access to the driver registry.

pub fn connection_providers(&self) -> &ConnectionProviderRegistry

Immutable access to the connection-provider registry.

pub fn connection_providers_mut(&mut self) -> &mut ConnectionProviderRegistry

Mutable access to the connection-provider registry.

pub fn built_in_harnesses(&self) -> &[BuiltInHarnessDefinition]

Built-in harness templates provisioned by this platform.

pub fn built_in_harnesses_mut(&mut self) -> &mut Vec<BuiltInHarnessDefinition>

Mutable access to the built-in harness templates.

pub fn egress_service(&self) -> Arc<dyn EgressService>

System-wide outbound network boundary.

pub fn email_sender(&self) -> Arc<dyn EmailSender>

System-wide email sender for product and operational flows.

pub fn utility_llm_service(&self) -> Arc<dyn UtilityLlmService>

System-wide utility LLM service for capability internals.

pub fn session_file_system_factory(&self) -> Arc<dyn SessionFileSystemFactory>

Factory for the platform-selected session filesystem implementation.

pub fn add_built_in_harness(&mut self, harness: BuiltInHarnessDefinition)

Append a built-in harness template.

pub fn harness_for_role( &self, role: BuiltInHarnessRole, ) -> Option<&BuiltInHarnessDefinition>

Find the first built-in harness with the requested role.

Trait Implementations

impl Clone for PlatformDefinition

fn clone(&self) -> PlatformDefinition

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PlatformDefinition

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

Formats the value using the given formatter.

impl Default for PlatformDefinition

fn default() -> Self

Returns the “default value” for a type.