Struct AgentManifest 

pub struct AgentManifest {
    pub metadata: AgentMetadata,
    pub requirements: Option<Requirements>,
    pub config: HashMap<String, Value>,
}

Agent configuration manifest.

Represents the complete configuration for a AGPM agent, including metadata, requirements, and custom configuration. This structure can be loaded from standalone TOML files or extracted from Markdown frontmatter.

Structure

• metadata: Core information about the agent
• requirements: Optional dependency and platform requirements
• config: Custom configuration as key-value pairs

Examples

Minimal Agent

use agpm_cli::config::{AgentManifest, AgentMetadata};
use std::collections::HashMap;

let manifest = AgentManifest {
    metadata: AgentMetadata {
        name: "simple-agent".to_string(),
        description: "A simple agent".to_string(),
        author: "Developer".to_string(),
        license: "MIT".to_string(),
        homepage: None,
        repository: None,
        keywords: vec![],
        categories: vec![],
    },
    requirements: None,
    config: HashMap::new(),
};

Loading from File

use agpm_cli::config::AgentManifest;
use std::path::Path;

let manifest = AgentManifest::load(Path::new("my-agent.toml"))?;
println!("Loaded agent: {}", manifest.metadata.name);

Fields

metadata: AgentMetadata

Core metadata about the agent.

Contains essential information like name, description, author, and categorization. This metadata is used for discovery, documentation, and dependency resolution.

requirements: Option<Requirements>

Optional requirements and dependencies.

Specifies version requirements, platform constraints, and dependencies on other resources. If None, the agent has no special requirements.

config: HashMap<String, Value>

Custom configuration values.

Arbitrary key-value pairs that can be used by the agent for configuration. Values can be any valid TOML type (string, number, boolean, array, table).

Examples

[config]
max_tokens = 4000
style = "verbose"
features = ["linting", "formatting"]

[config.advanced]
retry_attempts = 3
timeout_seconds = 30

Implementations

impl AgentManifest

pub fn load(path: &Path) -> Result<Self>

Load agent manifest from a TOML file.

Reads and parses an agent configuration file from the specified path.

Parameters

• path: Path to the TOML configuration file

Examples

use agpm_cli::config::AgentManifest;
use std::path::Path;

let manifest = AgentManifest::load(Path::new("agents/rust-expert.toml"))?;
println!("Agent: {}", manifest.metadata.name);

Errors

Returns an error if:

• The file cannot be read (not found, permissions, etc.)
• The file contains invalid TOML syntax
• The TOML structure doesn’t match the expected schema

Trait Implementations

impl Clone for AgentManifest

fn clone(&self) -> AgentManifest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentManifest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentManifest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentManifest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.