Struct HostState 

pub struct HostState {
    pub extension_id: String,
    pub permissions: Permissions,
    pub call_depth: AtomicU32,
    /* private fields */
}

Per-Store host context. One HostState is built per WIT invocation — the dependencies live in Arcs so cloning is cheap.

Fields

extension_id: String

permissions: Permissions

call_depth: AtomicU32

Implementations

impl HostState

pub fn builder( extension_id: String, permissions: Permissions, ) -> HostStateBuilder

Builder used by LoadedExtension::build_store_and_instance to produce a HostState for a single dispatch.

pub fn translator(&self) -> &dyn Translator

pub fn secrets_backend(&self) -> &dyn SecretsBackend

pub fn url_matcher(&self) -> &UrlMatcher

Trait Implementations

impl Host for HostState

fn log(&mut self, level: Level, target: String, message: String)

fn log_kv( &mut self, level: Level, target: String, message: String, fields: Vec<(String, String)>, )

impl Host for HostState

fn t(&mut self, key: String) -> String

fn tf(&mut self, key: String, args: Vec<(String, String)>) -> String

impl Host for HostState

fn get(&mut self, uri: String) -> Result<String, String>

impl Host for HostState

fn call_extension( &mut self, kind: String, target_id: String, function: String, _args_json: String, ) -> Result<String, String>

impl Host for HostState

fn fetch(&mut self, req: Request) -> Result<Response, String>

impl Host for HostState

fn complete(&mut self, request: LlmRequest) -> Result<LlmResponse, String>

impl Host for HostState

fn get_token( &mut self, provider_id: String, _subject: String, scopes: Vec<String>, ) -> String

Retrieve a token for the given OAuth provider.

Permission gate: the provider must be declared in permissions.oauth_providers. If not, returns a JSON error string with "error": "permission_denied" — fails closed.

When permitted but no oauth_config or http_client is present (e.g. the runtime was not configured with an OAuth broker), returns "error": "oauth_broker_unconfigured".

The shared_secret is NEVER logged.

fn get_consent_url( &mut self, _provider_id: String, _subject: String, _scopes: Vec<String>, _redirect_path: String, _extra_json: String, ) -> String

Build a consent URL for the given OAuth provider.

Not yet implemented in the design-extension runtime — returns an empty string. Consent flows are handled by the OAuth broker service directly; this stub satisfies the WIT interface contract.

fn exchange_code( &mut self, _provider_id: String, _subject: String, _code: String, _redirect_path: String, ) -> String

Exchange an authorization code for a token set.

Not yet implemented in the design-extension runtime — returns an empty string. Code exchange is handled by the OAuth broker service directly; this stub satisfies the WIT interface contract.

impl WasiView for HostState

Implement WasiView so that wasmtime_wasi::p2::add_to_linker_sync can wire WASI host functions. cargo-component adds WASI imports to every component it builds, even if the Rust source never calls them.

fn ctx(&mut self) -> WasiCtxView<'_>

Yields mutable access to the WasiCtx configuration used for this context.