Struct TurnHandoffAvailableMessage 

pub struct TurnHandoffAvailableMessage {
    pub v: u64,
    pub tools: Vec<String>,
    pub worker_epoch: u64,
    pub relay_marker: Option<bool>,
    pub staged_files: Option<bool>,
    pub no_query_first: Option<bool>,
    pub uuid: String,
    pub session_id: String,
    pub extra: Map<String, Value>,
}

system/turn_handoff_available — emitted once by a cloud worker that accepts the turn_handoff control request, right after it registers, carrying what its registration wrote to external_metadata.turn_handoff. Lets a session client learn the capability from the event stream instead of reading worker state. Durable in the stream: a reader keeps the entry with the newest worker_epoch it has seen and ignores older ones; a worker life that does not accept turn_handoff emits nothing (CLI 2.1.273+).

Fields

v: u64

Contract version of the handoff registration (currently 1).

tools: Vec<String>

The tools whose calls this worker would accept.

worker_epoch: u64

The worker life announcing it.

relay_marker: Option<bool>

Present, and true, only when this worker uses the relay_marker member of a turn_handoff request; a client sends that member to no other worker.

staged_files: Option<bool>

Present, and true, when this worker starts a handed-off turn’s calls only after every stage_file control request it received earlier has finished or failed (or a wait limit has passed); a worker that omits it may start them while files are still downloading (CLI 2.1.278+).

no_query_first: Option<bool>

True when user messages with shouldQuery false that reach this worker before a turn_handoff request are appended, and acknowledged, before the handed-off turn produces any output. Exception: a request that continues a turn whose leading lines an earlier request appended; that turn goes first. A worker that omits it may run the turn first (CLI 2.1.278+).

uuid: String

session_id: String

extra: Map<String, Value>

Trait Implementations

impl Clone for TurnHandoffAvailableMessage

fn clone(&self) -> TurnHandoffAvailableMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TurnHandoffAvailableMessage

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TurnHandoffAvailableMessage

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TurnHandoffAvailableMessage

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

where __S: Serializer,

Serialize this value into the given Serde serializer.