Struct TranscriptsConfig 

pub struct TranscriptsConfig {
    pub default_ttl_secs: Option<i64>,
    pub archive_grace_secs: Option<i64>,
    pub namespaces: Option<HashMap<String, TranscriptNamespaceConfig>>,
    pub max_decompressed_bytes: Option<usize>,
}

[transcripts] block in config.toml — per-namespace TTL and archive grace overrides for the I3 lifecycle sweeper.

[transcripts]
default_ttl_secs   = 2592000   # 30 days; archive after this when memories all expired
archive_grace_secs = 604800    # 7 days; prune this long after archive

[transcripts.namespaces."team/audit"]
default_ttl_secs = 31536000    # 1 year — compliance retention override

[transcripts.namespaces."ephemeral/*"]
default_ttl_secs = 86400       # 1 day — short-lived scratchpad

Resolution: the sweeper picks the longest-prefix matching namespace override (with literal "*" patterns last), falls back to the global default_ttl_secs / archive_grace_secs on this struct, and finally to the compiled defaults above.

Fields

default_ttl_secs: Option<i64>

Global default seconds-since-creation before the sweeper considers a transcript archive-eligible. None → compiled default (DEFAULT_TRANSCRIPT_TTL_SECS = 30 days).

archive_grace_secs: Option<i64>

Global default seconds an archived transcript lingers before the prune phase deletes it. None → compiled default (DEFAULT_TRANSCRIPT_ARCHIVE_GRACE_SECS = 7 days).

namespaces: Option<HashMap<String, TranscriptNamespaceConfig>>

Per-namespace overrides keyed by namespace pattern. Patterns are matched literally first; a trailing /* selects every child namespace under the prefix; the bare "*" is the catch-all and is consulted last.

max_decompressed_bytes: Option<usize>

v0.7.0 I1 cap (#628 agent-3 follow-up): the maximum number of bytes a single transcript may decompress to before transcripts::fetch rejects it as a decompression bomb. None → compiled default (crate::transcripts::MAX_DECOMPRESSED_BYTES = 16 MiB). Operators with legitimately larger transcripts raise the cap explicitly; the cap is per-call, so concurrent fetches consume up to N × this value of transient memory.

Implementations

impl TranscriptsConfig

pub fn resolve(&self, namespace: &str) -> ResolvedTranscriptLifecycle

Resolve the lifecycle parameters for namespace.

Precedence:

1. Exact match in namespaces (e.g. "team/audit").
2. Longest matching prefix pattern ending in /* (e.g. "team/*" matches "team/eng" and "team/eng/inner").
3. Bare "*" wildcard.
4. The struct-level default_ttl_secs / archive_grace_secs.
5. The compiled defaults (DEFAULT_TRANSCRIPT_TTL_SECS / DEFAULT_TRANSCRIPT_ARCHIVE_GRACE_SECS).

Each field is resolved independently — a per-namespace override that only sets default_ttl_secs inherits the global archive_grace_secs. Non-positive values fall through to the next layer; positive values are clamped to MAX_TRANSCRIPT_LIFECYCLE_SECS so the resolved Duration addition can never overflow chrono.

pub fn auto_extract_for(&self, namespace: &str) -> bool

v0.7 I5 — resolve the auto_extract opt-in for namespace.

Same precedence walk as Self::resolve but folds the boolean field of TranscriptNamespaceConfig::auto_extract:

1. Exact match.
2. Longest-prefix prefix/* match.
3. Bare wildcard "*".
4. false (default off — matches the “every reference hook ships off-by-default” lesson from G10/G11).

The R5 reference extractor (tools/transcript-extractor/) reads this flag at the namespace gate before doing any LLM work, so a namespace that hasn’t opted in pays the cost of one HashMap lookup per pre_store fire and nothing more.

Trait Implementations

impl Clone for TranscriptsConfig

fn clone(&self) -> TranscriptsConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TranscriptsConfig

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

Formats the value using the given formatter.

impl Default for TranscriptsConfig

fn default() -> TranscriptsConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TranscriptsConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TranscriptsConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.