Struct InputContext 

pub struct InputContext { /* private fields */ }

Per-invocation input context. Owns the bytes the host staged for the guest to pull via the wasi:tensor/host input-len / read-input host functions.

This is the input counterpart to StreamingContext (which is output-only, guest → host). The gateway stages the request payload — e.g. the OpenAI completions shim stages the assembled prompt bytes — before the guest runs, and the guest copies them into its own linear memory.

Cloning is cheap: the bytes live behind an Arc<[u8]>, so a clone is a single refcount bump. An empty context (InputContext::empty) is the default for invocations the gateway did not stage input for — len() is 0 and read-input copies nothing.

Implementations

impl InputContext

pub fn empty() -> Self

Construct an empty context. len() returns 0; read-input copies nothing. This is the default for invocations the gateway did not stage any input for.

pub fn new(bytes: impl Into<Arc<[u8]>>) -> Self

Construct a context wrapping the given staged input bytes.

pub fn bytes(&self) -> &[u8]

Borrow the staged input bytes.

pub fn len_u32(&self) -> u32

Number of staged input bytes. Clamped to u32::MAX so the value fits the WIT input-len() -> u32 return type — a staged buffer above 4 GiB is implausible (the API body-size cap is far below that) but we saturate rather than wrap on the cast.

pub fn is_empty(&self) -> bool

true when no input bytes are staged.

Trait Implementations

impl Clone for InputContext

fn clone(&self) -> InputContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InputContext

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

Formats the value using the given formatter.

impl Default for InputContext

fn default() -> InputContext

Returns the “default value” for a type.