Struct AppServerTurnRequest 

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

Input payload for one app-server turn execution.

Fields

folder: PathBuf

Session worktree folder where the provider runtime executes.

live_transcript: Option<Arc<dyn LiveTranscript>>

Live in-memory transcript source updated by the streaming consumer.

When set, restart-and-retry reads the latest accumulated transcript from this source instead of the queued snapshot, ensuring content streamed before the crash is included in the replay prompt.

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.

prompt: TurnPrompt

Structured prompt payload for this turn.

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.

provider_conversation_id: Option<String>

Provider-native thread/session id used to resume context in a newly started runtime.

persisted_instruction_conversation_id: Option<String>

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

reasoning_level: ReasoningLevel

Reasoning effort preference for this turn.

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

session_id: String

Stable agentty session id.

Trait Implementations

impl Clone for AppServerTurnRequest

fn clone(&self) -> AppServerTurnRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.