Struct CreateSessionRequest 

pub struct CreateSessionRequest {
    pub model: String,
    pub prompt: ContentInput,
    pub render_metadata: Option<RenderMetadata>,
    pub system_prompt: Option<String>,
    pub max_tokens: Option<u32>,
    pub event_tx: Option<Sender<EventEnvelope<AgentEvent>>>,
    pub skill_references: Option<Vec<SkillKey>>,
    pub initial_turn: InitialTurnPolicy,
    pub deferred_prompt_policy: DeferredPromptPolicy,
    pub build: Option<SessionBuildOptions>,
    pub labels: Option<BTreeMap<String, String>>,
}

Request to create a new session and run the first turn.

Fields

model: String

Model name (e.g. “claude-opus-4-6”).

prompt: ContentInput

Initial user prompt (text or multimodal).

render_metadata: Option<RenderMetadata>

Optional normalized rendering metadata for the initial prompt.

system_prompt: Option<String>

Optional system prompt override.

max_tokens: Option<u32>

Max tokens per LLM turn.

event_tx: Option<Sender<EventEnvelope<AgentEvent>>>

Channel for streaming events during the turn.

skill_references: Option<Vec<SkillKey>>

Canonical SkillKeys to resolve and inject for the first turn.

initial_turn: InitialTurnPolicy

Initial turn behavior for this session creation call.

deferred_prompt_policy: DeferredPromptPolicy

How to treat prompt when initial_turn == Defer.

build: Option<SessionBuildOptions>

Optional extended build options for factory-backed builders.

labels: Option<BTreeMap<String, String>>

Optional key-value labels attached at session creation.

Trait Implementations

impl Debug for CreateSessionRequest

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

Formats the value using the given formatter.