Struct SparkConfig 

pub struct SparkConfig {
    pub callsign: String,
    pub class: String,
    pub aura: String,
    pub signal: String,
    pub core: String,
}

Agent identity configuration.

All fields default to empty strings. When all fields are empty, the agent uses the default “Astrid” identity (zero behavior change).

Fields

callsign: String

Agent’s name (e.g. “Stellar”, “Nova”, “Orion”).

class: String

Role archetype (e.g. “navigator”, “engineer”, “sentinel”).

aura: String

Personality energy (e.g. “calm”, “sharp”, “warm”, “analytical”).

signal: String

Communication style (e.g. “formal”, “concise”, “casual”, “poetic”).

core: String

Soul/philosophy — free-form values, learned patterns, personality depth.

Implementations

impl SparkConfig

pub fn is_empty(&self) -> bool

Returns true when all fields are empty (no identity configured).

pub fn sanitize(&mut self)

Sanitize all fields: trim whitespace, enforce length limits, and remove newlines from short fields. Whitespace-only fields become empty.

pub fn load_from_file(path: &Path) -> Option<SparkConfig>

Load a spark config from a TOML file.

Returns None if the file is missing, too large, or cannot be parsed.

pub fn save_to_file(&self, path: &Path) -> Result<(), ToolError>

Save the spark config to a TOML file.

Creates parent directories if they don’t exist. Sanitizes before writing.

Errors

Returns a ToolError if directory creation or file writing fails.

pub fn build_preamble(&self) -> Option<String>

Build the identity preamble for system prompt injection.

When all fields are empty, returns None (caller should use the default “Astrid” opening). When at least one field is set, builds a structured identity block.

pub fn merge(&mut self, other: &SparkConfig)

Merge another spark into this one, only updating non-empty fields.

pub fn merge_optional( &mut self, callsign: Option<&str>, class: Option<&str>, aura: Option<&str>, signal: Option<&str>, core: Option<&str>, )

Merge optional field updates. None = don’t touch, Some(value) = set (including Some("") to clear a field).

Trait Implementations

impl Clone for SparkConfig

fn clone(&self) -> SparkConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SparkConfig

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

Formats the value using the given formatter.

impl Default for SparkConfig

fn default() -> SparkConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SparkConfig

where SparkConfig: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SparkConfig

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.