Struct CompletionsRequest 

#[non_exhaustive]
pub struct CompletionsRequest {
    pub model: String,
    pub prompt: Value,
    pub max_tokens: Option<u32>,
    pub temperature: Option<f32>,
    pub stream: Option<bool>,
    pub echo: Option<bool>,
    pub n: Option<u32>,
    pub user: Option<String>,
}

Body of POST /v1/completions.

Mirrors the public OpenAI REST contract documented at https://platform.openai.com/docs/api-reference/completions/create.

Every field is #[serde(default)] so an SDK that omits an optional knob still deserialises cleanly. We do not (yet) validate the values — the scaffold’s only contract is “the request parses; we then reject with 501”. The v0.4 wiring step adds:

• model → FunctionRecord lookup;
• prompt → guest argv marshalling;
• max_tokens / temperature / stream → executor knobs.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

model: String

Model identifier. In v0.4 this will resolve to a deployed FunctionRecord via a model → function_id map (env-driven allowlist + alias table).

prompt: Value

Prompt text. Accepts either a single string or an array of strings on the wire — represented here as serde_json::Value so the scaffold does not commit to one shape ahead of the translator.

max_tokens: Option<u32>

Maximum tokens to generate. Optional in the OpenAI contract; defaults to 16 if absent on the wire (v0.4 will mirror).

temperature: Option<f32>

Sampling temperature in [0.0, 2.0]. Optional; defaults to 1.0.

stream: Option<bool>

Stream the response as SSE if true. v0.4 wires; scaffold ignores.

echo: Option<bool>

Echo of the input plus completion (OpenAI compat knob).

n: Option<u32>

Number of completions to generate per prompt.

user: Option<String>

Caller-supplied request id, surfaced back on the response in OpenAI’s own logs. We accept and ignore.

Trait Implementations

impl Clone for CompletionsRequest

fn clone(&self) -> CompletionsRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CompletionsRequest

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

Formats the value using the given formatter.

impl Default for CompletionsRequest

fn default() -> CompletionsRequest

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CompletionsRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CompletionsRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.