Enum ContextPolicy 

pub enum ContextPolicy {
    Car,
    SelfManaged,
}

Who owns the agent’s conversation context across a multi-turn run.

The daemon already bounds the assistant and coder loops to the model’s context window; a declarative agent had no such bound and no way to ask for one. This is that switch, per agent, named for who does the work rather than for a mechanism the spec author cannot see.

Deserialization is deliberately TOLERANT (see the hand-written impl below): an unrecognized value warns and falls back to ContextPolicy::Car rather than failing the parse. A strict impl would be a foot-gun here — the authoring guide teaches hand-editing declagents.json, and DeclRegistry treats an unparseable file as an empty registry that the next upsert writes back, so one mistyped policy would delete every agent on the box.

Variants

Car

CAR manages it: before each model call the running history is compacted to fit the model’s context window, exactly as the assistant and coder loops do (oldest middle turns dropped on a turn boundary, the system prompt and the original task pinned, a [history compacted: notice left behind). The default, so an agent that never thinks about context still gets a bounded one.

SelfManaged

The agent author manages it. CAR never compacts this agent’s history — the spec owns whatever summarizing, truncation or externalization it wants. Choose it deliberately: nothing else bounds the transcript.

Implementations

impl ContextPolicy

pub fn is_car_managed(self) -> bool

Whether CAR compacts this agent’s history.

Exhaustive on purpose (repo rule): a matches! here would make every future variant silently self-managed — i.e. would turn “we added a policy” into “we switched compaction off for it”, which is the failure mode with no symptom until a run overflows.

pub fn as_str(self) -> &'static str

The on-disk / on-the-wire spelling.

Trait Implementations

impl Clone for ContextPolicy

fn clone(&self) -> ContextPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ContextPolicy

impl Debug for ContextPolicy

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

Formats the value using the given formatter.

impl Default for ContextPolicy

fn default() -> ContextPolicy

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ContextPolicy

fn deserialize<D>( deserializer: D, ) -> Result<ContextPolicy, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Accepts "car" and "self"; ANYTHING else warns and yields Car.

The strict derive returned unknown variant, and one bad character in a hand-edited declagents.json then travelled the whole swallow chain — DeclRegistry::read_all maps a parse error to an empty registry, and the next upsert persists that emptiness — so a typo in an optional field could unregister every agent the user had. A field whose only two values both mean “keep running” must never be able to do that. The fallback is the managed default, which is also the safe one: the worst outcome of guessing wrong is a bounded history for an author who wanted to bound it themselves, and the warning says so.

The spec id is not reachable from here (serde hands this impl only the field’s own value), so the warning names the value; the surrounding spec is one declagents.json grep away.

impl Eq for ContextPolicy

impl PartialEq for ContextPolicy

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ContextPolicy

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ContextPolicy