Struct BundleEmbedder 

pub struct BundleEmbedder { /* private fields */ }

Production embedder: loads an application-owned bundle and executes it through the natively linked Traverse runtime.

Implementations

impl BundleEmbedder

pub fn init(config: EmbedderConfig) -> Result<Self, EmbedderError>

runtime.init: load, verify, and register the application bundle.

Errors

Returns an EmbedderError with a stable code when the bundle path cannot be resolved, the bundle schema version is unsupported, the bundle fails validation or registration, or the WASM executor cannot initialize. Rejections are deterministic and never fall back to a sidecar (spec 068 NFR-001).

pub fn inject_data_store(&mut self, store: HostDataStore)

Explicitly injects a host-owned DataStore.

This additive host surface is deliberately separate from capability execution. It accepts neither a root path nor a capability identity, so the runtime cannot derive storage locations or grant capability code direct access.

pub fn data_store_read( &mut self, key: &str, ) -> Result<Option<StateRecord>, EmbeddedDataStoreError>

Reads one host-owned state record from the injected DataStore.

Returns None when the injected store has no record for key.

Errors

Returns a safe typed failure when no store was injected or its read operation fails.

pub fn data_store_write( &mut self, record: StateRecord, ) -> Result<(), EmbeddedDataStoreError>

Writes one host-owned state record to the injected DataStore.

Errors

Returns a safe typed failure when no store was injected or its write operation fails.

pub fn data_store_delete( &mut self, key: &str, ) -> Result<(), EmbeddedDataStoreError>

Deletes one host-owned state record from the injected DataStore.

Errors

Returns a safe typed failure when no store was injected or its delete operation fails.

Trait Implementations

impl EmbeddedTraceApi for BundleEmbedder

fn embedded_trace_api_version(&self) -> &'static str

Returns the companion API version advertised by this host.

fn trace_list( &self, requested_version: &str, page_size: usize, cursor: Option<&str>, ) -> Result<EmbeddedTracePage, EmbeddedTraceApiError>

trace.list: returns a deterministic page of safe local summaries.

fn trace_get( &self, requested_version: &str, trace_id: &str, ) -> Result<EmbeddedTraceDetail, EmbeddedTraceApiError>

trace.get: returns one safe retained local trace detail.

impl TraverseEmbedderApi for BundleEmbedder

fn submit(&mut self, target_id: &str, input: &Value) -> SubmitOutcome

runtime.submit: execute a bundled workflow or WASM capability.

fn subscribe(&mut self, callback: EventCallback)

runtime.subscribe: register an ordered event callback. Previously emitted events are replayed to the new subscriber first, so late subscribers observe the identical ordered stream.

fn start_compatible( &mut self, capability_id: &str, input: &Value, ) -> CompatibleStartOutcome

compatible.start: start a compatible-mode capability instance.

fn stop_compatible( &mut self, capability_id: &str, instance_id: Option<&str>, ) -> CompatibleLifecycleOutcome

compatible.stop: gracefully stop one instance (instance_id) or every running instance of the capability (None).

fn kill_compatible( &mut self, capability_id: &str, instance_id: Option<&str>, ) -> CompatibleLifecycleOutcome

compatible.kill: force-terminate one instance (instance_id) or every running instance of the capability (None).

fn shutdown(&mut self) -> ShutdownOutcome

runtime.shutdown: kill running compatible instances and stop accepting operations. Idempotent.

fn release_evidence(&self) -> Value

Release evidence connecting this embedder to its package version, linked runtime, conformance version, and bundle digests (spec 068 FR-008, NFR-002).