Struct RuntimeHandle 

pub struct RuntimeHandle { /* private fields */ }

Public, cheaply-cloneable handle. All API surfaces drive the runtime through this — no direct access to internals.

Implementations

impl RuntimeHandle

pub async fn open(path: &Path) -> Result<Self>

Open / create the persistent store at path, then re-spawn tick tasks for any enabled vigies recorded there.

pub async fn open_in_memory() -> Result<Self>

In-memory store — only useful in tests + ephemeral one-shot runs.

pub async fn open_with_extensions( path: &Path, extensions: Vec<ExtensionHandle>, ) -> Result<Self>

Open with a custom extension bundle. mado calls this with standard_extensions() ++ [MadoTearExtension]; tear-daemon calls it with standard_extensions() ++ [TearCoreExtension]. Pure operators (vigy serve) take the default via [open] which uses vigy_eval::standard_extensions() only.

pub async fn register_or_update(&self, vigy: Vigy) -> Result<Vigy>

Register a fresh vigy (or replace if its id matches an existing one). The new task spawns immediately; the old task (if any) is cancelled before the new one starts to guarantee no concurrent ticks.

pub async fn enable(&self, id: &VigyId) -> Result<Vigy>

pub async fn disable(&self, id: &VigyId) -> Result<Vigy>

pub async fn delete(&self, id: &VigyId) -> Result<bool>

pub async fn get(&self, id: &VigyId) -> Result<Vigy>

pub async fn list(&self, label_selector: Option<&str>) -> Result<Vec<Vigy>>

pub async fn recent_runs(&self, id: &VigyId, limit: u64) -> Result<Vec<VigyRun>>

pub async fn tick_now(&self, id: &VigyId) -> Result<VigyRun>

Force-tick a vigy now, regardless of its schedule. Useful for carve gate-style CI hooks + the vigy <id> tick CLI.

pub async fn tick_now_with( &self, id: &VigyId, reconciler: &dyn Reconciler, ) -> Result<VigyRun>

Force-tick a vigy through a caller-supplied reconciler. Useful for tests that swap in NoopReconciler / ChainReconciler / a custom impl without changing the vigy’s stored program.

pub fn subscribe(&self) -> Receiver<VigyRun>

Subscribe to the reconcile event bus. Caller gets every tick’s finalised VigyRun until they drop the receiver.

Trait Implementations

impl Clone for RuntimeHandle

fn clone(&self) -> RuntimeHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.