Struct EmitRequest 

pub struct EmitRequest {
    pub provider: ProviderId,
    pub model: ModelName,
    pub input: String,
    pub session_id: Option<Uuid>,
    pub client_request_id: Option<String>,
    pub metadata: Value,
}

Transport-neutral request for a single runtime invocation.

Converts to RunRequest via EmitRequest::into_run_request. The invocation layer deliberately omits tool_choice and run_id: callers needing fine-grained control over those should construct a RunRequest directly and call AgentRuntime::run.

Fields

provider: ProviderId

Provider used for model calls.

model: ModelName

Model used for generation.

input: String

User input message.

session_id: Option<Uuid>

Optional session id. When None, the runtime creates a new session.

client_request_id: Option<String>

Optional client-provided idempotency key.

metadata: Value

Arbitrary metadata attached to the run. Defaults to Value::Null.

Implementations

impl EmitRequest

pub fn new( provider: ProviderId, model: ModelName, input: impl Into<String>, ) -> Self

Creates a new emit request with no session, no client id, and null metadata.

pub fn with_session_id(self, session_id: Uuid) -> Self

Sets the session id.

pub fn with_client_request_id(self, id: impl Into<String>) -> Self

Sets the client-provided idempotency key.

pub fn with_metadata(self, metadata: Value) -> Self

Sets the metadata payload.

pub fn into_run_request(self) -> RunRequest

Converts this request into a RunRequest consumed by the runtime.

tool_choice defaults to ToolChoice::Auto and run_id is left unset so the runtime allocates one.

Trait Implementations

impl Clone for EmitRequest

fn clone(&self) -> EmitRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EmitRequest

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

Formats the value using the given formatter.