Struct TurnRequest 

pub struct TurnRequest {
    pub folder: PathBuf,
    pub live_transcript: Option<Arc<dyn LiveTranscript>>,
    pub main_checkout_root: Option<PathBuf>,
    pub model: String,
    pub request_kind: AgentRequestKind,
    pub replay_transcript: Option<String>,
    pub prompt: TurnPrompt,
    pub provider_conversation_id: Option<String>,
    pub persisted_instruction_conversation_id: Option<String>,
    pub reasoning_level: ReasoningLevel,
}

Input payload for one provider-agnostic agent turn.

Fields

folder: PathBuf

Session worktree folder where the agent runs.

live_transcript: Option<Arc<dyn LiveTranscript>>

Live transcript source for app-server context reconstruction.

App-server clients may read this source during a turn to access content that was streamed before a prior crash, providing a more complete replay transcript than the snapshot captured at enqueue time. CLI channels ignore this field.

main_checkout_root: Option<PathBuf>

Main repository checkout that must remain read-only during the turn, when Agentty can resolve it.

model: String

Provider-specific model identifier.

request_kind: AgentRequestKind

Canonical request kind that drives transport behavior and protocol semantics for this turn.

replay_transcript: Option<String>

Replayable transcript text captured when the turn was queued.

prompt: TurnPrompt

Structured prompt payload for the turn.

provider_conversation_id: Option<String>

Provider-native conversation identifier loaded from persistence.

When present, app-server channels forward this to the provider runtime so it can attempt native context resume. CLI channels ignore this field.

persisted_instruction_conversation_id: Option<String>

Persisted provider-native conversation id that already received the full instruction bootstrap.

App-server channels use this to choose between a full bootstrap and a compact reminder for the active provider context. CLI channels ignore this field.

reasoning_level: ReasoningLevel

Reasoning effort preference for the turn.

Ignored by providers/models that do not support reasoning effort.

Trait Implementations

impl Clone for TurnRequest

fn clone(&self) -> TurnRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TurnRequest

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

Formats the value using the given formatter.