phi-core 0.10.0

Simple, effective agent loop with tool execution and event streaming
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

use crate::types::ThinkingLevel;
use serde::{Deserialize, Serialize};
use std::path::PathBuf;

/// A reusable agent blueprint that defines default configuration for agents.
///
/// Multiple agents can share the same profile, inheriting its settings as defaults.
/// Agent-level settings (e.g. `system_prompt` on `BasicAgent`) override the profile's
/// values when both are set.
///
/// ## Resolution order
///
/// For fields like `thinking_level` and `temperature`, the resolution order is:
///   1. Session override (if set)
///   2. Profile value (if set)
///   3. Crate default (`ThinkingLevel::Off`, `None`)
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AgentProfile {
    /// Unique identifier for this profile. Auto-generated UUID when using `Default`.
    #[serde(default = "default_profile_id")]
    pub profile_id: String,

    /// Human-readable name for agents using this profile.
    #[serde(default)]
    pub name: Option<String>,

    /// Description of the profile's purpose or capabilities.
    #[serde(default)]
    pub description: Option<String>,

    /// Default system prompt for agents using this profile.
    /// Can be overridden at the agent level.
    #[serde(default)]
    pub system_prompt: Option<String>,

    /// Default thinking level for agents using this profile.
    #[serde(default)]
    pub thinking_level: Option<ThinkingLevel>,

    /// Default temperature for agents using this profile.
    #[serde(default)]
    pub temperature: Option<f32>,

    /// Default max tokens for agents using this profile.
    #[serde(default)]
    pub max_tokens: Option<u32>,

    /// Stable config identity. When set, used as the middle segment of `loop_id`:
    ///   `loop_id = "{session_id}.{config_id}.{N}"`
    #[serde(default)]
    pub config_id: Option<String>,

    /// Skill names loaded via `SkillSet` from SKILL.md files.
    /// These are NOT tools — they are skill definitions per the AgentSkills standard.
    #[serde(default)]
    pub skills: Vec<String>,

    /// Agent workspace directory. File paths in system prompt blocks resolve
    /// relative to this directory.
    #[serde(default)]
    pub workspace: Option<PathBuf>,
}

fn default_profile_id() -> String {
    uuid::Uuid::new_v4().to_string()
}

impl Default for AgentProfile {
    fn default() -> Self {
        Self {
            profile_id: default_profile_id(),
            name: None,
            description: None,
            system_prompt: None,
            thinking_level: None,
            temperature: None,
            max_tokens: None,
            config_id: None,
            skills: Vec::new(),
            workspace: None,
        }
    }
}