codex-rs/core/src/rollout/mod.rs

//! Rollout module: persistence and discovery of session rollout files.

use codex_protocol::protocol::SessionSource;

pub const SESSIONS_SUBDIR: &str = "sessions";
pub const ARCHIVED_SESSIONS_SUBDIR: &str = "archived_sessions";
pub const INTERACTIVE_SESSION_SOURCES: &[SessionSource] =
    &[SessionSource::Cli, SessionSource::VSCode];

pub mod list;
pub(crate) mod policy;
pub mod recorder;

pub use codex_protocol::protocol::SessionMeta;
pub use list::find_conversation_path_by_id_str;
pub use recorder::RolloutRecorder;
pub use recorder::RolloutRecorderParams;

#[cfg(test)]
pub mod tests;
core(rollout): extract rollout module, add listing API, and return file heads (#1634) - Move rollout persistence and listing into a dedicated module: rollout/{recorder,list}. - Expose lightweight conversation listing that returns file paths plus the first 5 JSONL records for preview. 2025-09-03 00:39:19 -07:00			`//! Rollout module: persistence and discovery of session rollout files.`

Separate interactive and non-interactive sessions (#4612) Do not show exec session in VSCode/TUI selector. 2025-10-02 13:06:21 -07:00			`use codex_protocol::protocol::SessionSource;`

feat: add ArchiveConversation to ClientRequest (#3353) Adds support for `ArchiveConversation` in the JSON-RPC server that takes a `(ConversationId, PathBuf)` pair and: - verifies the `ConversationId` corresponds to the rollout id at the `PathBuf` - if so, invokes `ConversationManager.remove_conversation(ConversationId)` - if the `CodexConversation` was in memory, send `Shutdown` and wait for `ShutdownComplete` with a timeout - moves the `.jsonl` file to `$CODEX_HOME/archived_sessions` --------- Co-authored-by: Gabriel Peal <gabriel@openai.com> 2025-09-09 08:39:00 -07:00			`pub const SESSIONS_SUBDIR: &str = "sessions";`
			`pub const ARCHIVED_SESSIONS_SUBDIR: &str = "archived_sessions";`
Separate interactive and non-interactive sessions (#4612) Do not show exec session in VSCode/TUI selector. 2025-10-02 13:06:21 -07:00			`pub const INTERACTIVE_SESSION_SOURCES: &[SessionSource] =`
			`&[SessionSource::Cli, SessionSource::VSCode];`
core(rollout): extract rollout module, add listing API, and return file heads (#1634) - Move rollout persistence and listing into a dedicated module: rollout/{recorder,list}. - Expose lightweight conversation listing that returns file paths plus the first 5 JSONL records for preview. 2025-09-03 00:39:19 -07:00
			`pub mod list;`
Introduce Rollout Policy (#3116) Have a helper function for deciding if we are rolling out a function or not 2025-09-03 10:37:07 -07:00			`pub(crate) mod policy;`
core(rollout): extract rollout module, add listing API, and return file heads (#1634) - Move rollout persistence and listing into a dedicated module: rollout/{recorder,list}. - Expose lightweight conversation listing that returns file paths plus the first 5 JSONL records for preview. 2025-09-03 00:39:19 -07:00			`pub mod recorder;`

Move initial history to protocol (#3422) To fix an edge case of forking then resuming #3419 2025-09-10 10:17:24 -07:00			`pub use codex_protocol::protocol::SessionMeta;`
enable-resume (#3537) Adding the ability to resume conversations. we have one verb `resume`. Behavior: `tui`: `codex resume`: opens session picker `codex resume --last`: continue last message `codex resume <session id>`: continue conversation with `session id` `exec`: `codex resume --last`: continue last conversation `codex resume <session id>`: continue conversation with `session id` Implementation: - I added a function to find the path in `~/.codex/sessions/` with a `UUID`. This is helpful in resuming with session id. - Added the above mentioned flags - Added lots of testing 2025-09-14 19:33:19 -04:00			`pub use list::find_conversation_path_by_id_str;`
core(rollout): extract rollout module, add listing API, and return file heads (#1634) - Move rollout persistence and listing into a dedicated module: rollout/{recorder,list}. - Expose lightweight conversation listing that returns file paths plus the first 5 JSONL records for preview. 2025-09-03 00:39:19 -07:00			`pub use recorder::RolloutRecorder;`
Generate more typescript types and return conversation id with ConversationSummary (#3219) This PR does multiple things that are necessary for conversation resume to work from the extension. I wanted to make sure everything worked so these changes wound up in one PR: 1. Generate more ts types 2. Resume rollout history files rather than create a new one every time it is resumed so you don't see a duplicate conversation in history for every resume. Chatted with @aibrahim-oai to verify this 3. Return conversation_id in conversation summaries 4. [Cleanup] Use serde and strong types for a lot of the rollout file parsing 2025-09-08 14:54:47 -07:00			`pub use recorder::RolloutRecorderParams;`
core(rollout): extract rollout module, add listing API, and return file heads (#1634) - Move rollout persistence and listing into a dedicated module: rollout/{recorder,list}. - Expose lightweight conversation listing that returns file paths plus the first 5 JSONL records for preview. 2025-09-03 00:39:19 -07:00
			`#[cfg(test)]`
			`pub mod tests;`