Struct DeclarativeAgentSpec 

pub struct DeclarativeAgentSpec {

    pub id: String,
    pub name: String,
    pub identity: String,
    pub tools: Vec<String>,
    pub denied_tools: Vec<String>,
    pub standing_goal: String,
    pub goal: Option<DeclarativeGoal>,
    pub cadence: Option<AgentCadence>,
    pub scenarios: Vec<Scenario>,
    pub builder_draft: Option<AgentBuilderDraft>,
    pub previous: Option<Box<DeclarativeAgentSpec>>,
    pub enabled: bool,
    pub context: ContextPolicy,
}

A declarative, in-daemon agent.

Fields

id: String

Filename-safe id (derived from the project slug).

name: String

identity: String

System prompt — who the agent is and how it behaves.

tools: Vec<String>

Allowlist of tool names the agent may call. The daemon exposes ONLY these to the model; anything else is invisible. Empty = no tools (a pure-reasoning agent).

denied_tools: Vec<String>

Extra hard denials layered under the allowlist (belt and suspenders).

standing_goal: String

The agent’s persistent objective, prepended to every run.

goal: Option<DeclarativeGoal>

Optional deterministic completion contract. This is not shown to the model as a tool; it is the runtime-owned verifier for each invocation.

cadence: Option<AgentCadence>

The user’s structured cadence request. Existing specs predate this field, so absence remains valid and means no cadence was requested.

scenarios: Vec<Scenario>

Acceptance scenarios — the contract the coder→agent loop drives to green.

builder_draft: Option<AgentBuilderDraft>

The seven user-authored Agent Builder answers and selected template. Legacy and hand-authored specs have no draft and continue to load.

previous: Option<Box<DeclarativeAgentSpec>>

The immediately preceding registered version. Upsert always truncates this to one level, so repeated edits cannot grow an unbounded history.

enabled: bool

Lifecycle toggle. A disabled agent stays registered but won’t run.

context: ContextPolicy

Who manages the conversation context of a run: CAR (compaction keyed to the model’s context window, the default) or the agent itself.

#[serde(default)] is load-bearing: every spec already written to declagents.json predates this field and must keep loading, with the same managed behavior a new one gets.

Implementations

impl DeclarativeAgentSpec

pub fn validate(&self) -> Vec<String>

Structural problems that make a spec unusable. Empty = valid.

Trait Implementations

impl Clone for DeclarativeAgentSpec

fn clone(&self) -> DeclarativeAgentSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DeclarativeAgentSpec

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DeclarativeAgentSpec

fn deserialize<__D>( __deserializer: __D, ) -> Result<DeclarativeAgentSpec, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for DeclarativeAgentSpec

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for DeclarativeAgentSpec

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 DeclarativeAgentSpec