Struct Talks 

pub struct Talks { /* private fields */ }

A conversation store on disk.

Implementations

impl Talks

pub fn open() -> Self

The operator’s conversations, <home>/talks.

pub fn at(root: PathBuf) -> Self

A store at an explicit root. Tests use this, which is why none of them need the operator’s real home.

pub fn root(&self) -> &Path

Directory holding the conversation files.

pub fn path_of(&self, id: &str) -> PathBuf

Path for one conversation id.

pub fn artifacts_of(&self, id: &str) -> PathBuf

Where one conversation’s prompts and CLI output are kept, beside the record rather than inside it - see crate::chat::Chats::artifacts_of.

pub fn put(&self, t: &mut Talk) -> Result<()>

Write a conversation, atomically, so a process killed mid-write leaves the previous state readable rather than a truncated file.

pub fn get(&self, id: &str) -> Result<Talk>

Load a conversation by id or unambiguous id prefix.

pub fn list(&self) -> Vec<Talk>

Every conversation on disk: open first, then newest first - the same ordering crate::chat::Chats::list uses, for the same reason: what the operator is still using belongs above what they are done with.

pub fn resolve_id(&self, prefix: &str) -> Result<String>

Expand an id prefix to exactly one conversation id.

pub fn revision(&self) -> u64

Change detection token, the same shape as crate::chat::Chats::revision: the newest modification time in the store, in milliseconds.

pub fn count_open(&self) -> usize

How many conversations are still open.

pub fn remove(&self, id: &str) -> Result<()>

Remove a conversation from disk, record and artifacts both. The operator’s way of saying “not just done, gone” - close alone leaves the record as history.

Takes Talks::guard for the same reason close does: a delete racing a record or the tail of [turn] must not land between their own read and write, or the file removed here would look, to them, like a record that simply has not been written yet. The other half of that story is on their side - both check under this same guard that the record they are about to write is still there, and give up without writing if it is not, which is what stops their put from resurrecting a conversation this call already removed.

Trait Implementations

impl Clone for Talks

fn clone(&self) -> Talks

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Talks

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

Formats the value using the given formatter.