Struct Session 

pub struct Session {
    pub state: Value,
    pub questions: Vec<Entry>,
    pub model: Option<String>,
}

Everything the next :ask will send.

Fields

state: Value

The text or JSON the model reasons about.

questions: Vec<Entry>

Named questions, in insertion order.

model: Option<String>

Per-session model override; None means the client default.

Implementations

impl Session

pub fn new() -> Self

pub fn state_is_empty(&self) -> bool

pub fn state_preview(&self) -> String

One-line preview of the state for the side panel.

pub fn turns(&self) -> Option<Vec<Turn>>

The state read as a conversation, or None when it is something else.

pub fn add_turn(&mut self, turn: Turn) -> Result<Vec<Turn>, String>

Append a turn to the state.

An empty state starts a thread and a thread grows by one. A state that is plain text becomes the first turn, because that is how a session usually begins — one message, then the reply to it. Any other JSON is refused rather than reshaped: whatever it is, it is not a conversation, and guessing at one would lose it.

pub fn drop_turn(&mut self) -> Option<Turn>

Take the last turn back. The last one of all leaves the state empty again.

pub fn insert(&mut self, name: String, question: Question) -> bool

Add a question, or replace one of the same name in place.

pub fn remove(&mut self, name: &str) -> bool

pub fn to_questions(&self) -> Questions

pub fn request_json(&self, model: &str) -> String

The exact JSON body the SDK will POST to /v1/systemone.

Serialized through a struct (not a Value) so field and question order survive, which is the whole point of showing it.

pub fn request_json_compact(&self, model: &str) -> String

The same body Session::request_json shows, with the whitespace taken out: what a cache key hashes.

Trait Implementations

impl Clone for Session

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Session

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

Formats the value using the given formatter.

impl Default for Session

fn default() -> Self

Returns the “default value” for a type.