Struct InjectionEngine 

pub struct InjectionEngine<P: AiProvider + ?Sized> { /* private fields */ }

The main engine for AI code injection.

Example

use aether_core::{InjectionEngine, Template, AetherConfig};
use aether_ai::OpenAiProvider;

let provider = OpenAiProvider::from_env()?;
 
// Using config
let config = AetherConfig::from_env();
let engine = InjectionEngine::with_config(provider, config);

// Or simple
let engine = InjectionEngine::new(provider);

Implementations

impl<P: AiProvider + ?Sized + 'static> InjectionEngine<P>

pub fn new(provider: P) -> Self

where P: Sized,

Create a new injection engine with the given provider and default config.

pub fn new_raw(provider: Arc<P>) -> Self

Internal: Create a raw engine without full config for script-based calls.

pub fn with_config(provider: P, config: AetherConfig) -> Self

where P: Sized,

Create a new injection engine with the given provider and config.

pub fn with_config_arc(provider: Arc<P>, config: AetherConfig) -> Self

Create a new injection engine with the given provider (Arc) and config.

pub fn with_cache(self, cache: impl Cache + 'static) -> Self

Set the cache for performance optimization.

pub fn with_toon(self, enabled: bool) -> Self

Enable or disable TOON format for context.

pub fn with_validator(self, validator: impl Validator + 'static) -> Self

Set the validator for self-healing.

pub fn with_context(self, context: InjectionContext) -> Self

Set the global context.

pub fn parallel(self, enabled: bool) -> Self

Enable or disable parallel generation.

pub fn max_retries(self, retries: u32) -> Self

Set maximum retries for failed generations.

pub fn cache(&self) -> Option<Arc<dyn Cache>>

Get the current cache.

pub fn with_observer(self, observer: impl EngineObserver + 'static) -> Self

Set an observer for tracking events.

pub async fn render(&self, template: &Template) -> Result<String>

Render a template with AI-generated code.

This method will generate code for all slots in the template and return the final rendered content.

pub async fn render_with_context( &self, template: &Template, context: InjectionContext, ) -> Result<String>

Render a template with additional context.

pub async fn render_incremental( &self, template: &Template, session: &mut RenderSession, ) -> Result<String>

Render a template incrementally using a session.

This will only generate code for slots that have changed based on their definition and the current context.

pub async fn generate_slot( &self, template: &Template, slot_name: &str, ) -> Result<String>

Generate code for a single slot.

pub fn generate_slot_stream( &self, template: &Template, slot_name: &str, ) -> Result<BoxStream<'static, Result<StreamResponse>>>

Generate code for a single slot as a stream.

pub async fn inject_raw(&self, prompt: &str) -> Result<String>

Inject a raw prompt and get the code back directly. Used primarily by the script runtime.