Struct RecoverOpts 

pub struct RecoverOpts {
    pub host: HostKind,
    pub transcript_override: Option<PathBuf>,
    pub since_iso: Option<String>,
    pub namespace: Option<String>,
    pub limit: usize,
    pub dry_run: bool,
    pub quiet: bool,
    pub agent_id: String,
}

Per-call recovery options. Both surfaces (CLI + MCP) build one of these from their respective Args / Request shapes and pass it into recover_from_transcript.

Fields

host: HostKind

Which host’s transcript format + path-resolver arm to use.

transcript_override: Option<PathBuf>

Explicit transcript path; when None, the resolver walks the per-host candidate set and picks the most-recent.

since_iso: Option<String>

Filter to lines whose timestamp is at or after this RFC3339 instant. When None, recovery starts from the most-recent-memory_store watermark for this agent_id.

namespace: Option<String>

Namespace to land recovered memories in. When None, defaults to the agent’s resolved default namespace per AppConfig.

limit: usize

Maximum number of transcript lines to atomise this run. Excess lines are skipped + counted under lines_skipped_limit. Defaults to DEFAULT_RECOVER_LIMIT.

dry_run: bool

When true, parse the transcript and emit the report but write nothing to the DB. Used by --dry-run for operator inspection.

quiet: bool

When true, drop every memory_id from memories_created except the first QUIET_MEMORY_ID_PREVIEW_CAP; bounds the JSON payload for SessionStart-hook log capture.

agent_id: String

agent_id to attribute recovered memories to. Resolved from the calling surface (CLI flag / MCP CallerContext / config).

Implementations

impl RecoverOpts

pub fn for_session_start_hook(host: HostKind, agent_id: String) -> Self

Sensible defaults for SessionStart-hook integration. Callers override agent_id (required) and any other field that diverges from the hook-friendly defaults.

Trait Implementations

impl Clone for RecoverOpts

fn clone(&self) -> RecoverOpts

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RecoverOpts

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

Formats the value using the given formatter.