Skip to main content

SessionJournal

Struct SessionJournal 

Source
pub struct SessionJournal {
    pub entries: Vec<SessionEntry>,
    pub leaf_id: Option<EntryId>,
    pub schema_version: u32,
    pub spawn_depth: u32,
}

Fields§

§entries: Vec<SessionEntry>§leaf_id: Option<EntryId>§schema_version: u32§spawn_depth: u32

Implementations§

Source§

impl SessionJournal

Source

pub fn new() -> Self

Source

pub fn with_spawn_depth(depth: u32) -> Self

Source

pub fn append(&mut self, kind: SessionEntryKind) -> EntryId

Source

pub fn append_stamped( &mut self, kind: SessionEntryKind, created_at: DateTime<Utc>, ) -> EntryId

Append an entry carrying the time the underlying event happened, not the time the save ran. created_at is the journal’s timeline; stamping it at append is what keeps a rebuilt journal honest — a save must never rewrite an entry’s time to the moment it was written.

Source

pub fn append_message(&mut self, message: Message) -> EntryId

Source

pub fn append_compaction( &mut self, summary: String, tokens_before: Option<u64>, tokens_after: Option<u64>, model: Option<String>, ) -> EntryId

Source

pub fn append_branch_summary( &mut self, branch_id: String, summary: String, parent_branch_id: Option<String>, ) -> EntryId

Source

pub fn branch_to(&mut self, entry_id: &str) -> Result<(), String>

Source

pub fn fork_from(&self, from_entry_id: Option<&str>) -> Result<Self, String>

Source

pub fn index(&self) -> HashMap<&str, &SessionEntry>

Source

pub fn contains(&self, entry_id: &str) -> bool

Source

pub fn leaf(&self) -> Option<&SessionEntry>

Source

pub fn root_to_leaf(&self) -> Vec<&SessionEntry>

Source

pub fn active_messages(&self, include_system: bool) -> Vec<Message>

Source

pub fn leaves(&self) -> Vec<&SessionEntry>

Source

pub fn is_empty(&self) -> bool

Source

pub fn len(&self) -> usize

Source

pub fn validate(&self) -> Result<(), String>

Source

pub fn from_messages(messages: Vec<Message>, spawn_depth: u32) -> Self

Source

pub fn from_messages_stamped( messages: Vec<Message>, stamps: &[DateTime<Utc>], spawn_depth: u32, ) -> Self

Build the journal honoring a per-message append stamp. stamps[i] is the time messages[i] entered the conversation; a missing stamp falls back to now, so a drifted caller degrades to save-time ordering rather than dropping the message.

Source

pub fn to_messages(&self) -> Vec<Message>

Source

pub fn rebranch_active_messages(&mut self, messages: &[Message]) -> Rebranch

Keep the shared prefix and its original stamps. A provisional user entry can gain its Engine stamp until another branch shares it.

Source

pub fn rebranch_active_messages_stamped( &mut self, messages: &[Message], stamps: &[DateTime<Utc>], ) -> Rebranch

Preserve existing entry identity and timestamps; only append the changed suffix, keeping the previous branch reachable.

Source

pub fn prune_plan( &self, dead_threshold: usize, dead_budget: usize, ) -> Vec<EntryId>

Ids a bounded save may move out of this journal, in journal order.

Empty until more than dead_threshold entries sit off the active branch — superseded versions left behind by compaction, undo and edits (#6842). Past it, the plan keeps the root→leaf path, then whole off-branch chains (an entry with every ancestor) newest first, with Compaction/BranchSummary chains ahead of plain leaves, while the kept off-branch total stays within dead_budget. A kept entry never loses its parent, so the remainder always passes Self::validate.

Pure: callers archive the planned entries durably before removing them with Self::remove_entries. Known limit: the active branch itself is never pruned, so a session that never compacts stays as long as its conversation.

Source

pub fn remove_entries( &mut self, ids: &HashSet<EntryId>, ) -> Result<usize, String>

Remove ids atomically: either every listed entry leaves and the remainder still validates, or the journal is left exactly as it was and the validation error is returned. Returns how many were removed.

Trait Implementations§

Source§

impl Clone for SessionJournal

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for SessionJournal

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for SessionJournal

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl<'de> Deserialize<'de> for SessionJournal

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl PartialEq for SessionJournal

Source§

fn eq(&self, other: &Self) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl Serialize for SessionJournal

Source§

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

Serialize this value into the given Serde serializer. Read more
Source§

impl StructuralPartialEq for SessionJournal

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<T> Downcast for T
where T: Any,

Source§

fn into_any(self: Box<T>) -> Box<dyn Any>

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.
Source§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
Source§

fn as_any(&self) -> &(dyn Any + 'static)

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
Source§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
Source§

impl<T> DowncastSync for T
where T: Any + Send + Sync,

Source§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Sync + Send> ⓘ

Convert Arc<Trait> (where Trait: Downcast) to Arc<Any>. Arc<Any> can then be further downcast into Arc<ConcreteType> where ConcreteType implements Trait.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more