use serde::{Deserialize, Deserializer, Serialize}; /// Avatar for a persona — either a remote URL or a local file in ~/.goose/avatars/. #[derive(Debug, Clone, Serialize, Deserialize)] #[serde(tag = "type", content = "value")] pub enum Avatar { #[serde(rename = "url")] Url(String), #[serde(rename = "local")] Local(String), } /// Custom deserializer that handles migration from old format. /// Accepts: /// - null → None /// - "https://..." (bare string) → Some(Avatar::Url(s)) /// - { "type": "url", "value": "..." } → Some(Avatar::Url(...)) /// - { "type": "local", "value": "x" } → Some(Avatar::Local(...)) fn deserialize_avatar_compat<'de, D>(deserializer: D) -> Result, D::Error> where D: Deserializer<'de>, { #[derive(Deserialize)] #[serde(untagged)] enum AvatarOrString { Avatar(Avatar), BareString(String), } let opt: Option = Option::deserialize(deserializer)?; match opt { None => Ok(None), Some(AvatarOrString::BareString(s)) => { if s.is_empty() { Ok(None) } else { Ok(Some(Avatar::Url(s))) } } Some(AvatarOrString::Avatar(a)) => Ok(Some(a)), } } /// Deserializer for UpdatePersonaRequest: distinguishes "field absent" from "field: null". /// - JSON field absent → None (don't update) /// - "avatar": null → Some(None) (clear the avatar) /// - "avatar": {...} or "str" → Some(Some(Avatar)) fn deserialize_avatar_update<'de, D>(deserializer: D) -> Result>, D::Error> where D: Deserializer<'de>, { #[derive(Deserialize)] #[serde(untagged)] enum AvatarOrString { Avatar(Avatar), BareString(String), } let opt: Option = Option::deserialize(deserializer)?; match opt { None => Ok(Some(None)), // explicit null → clear Some(AvatarOrString::BareString(s)) => { if s.is_empty() { Ok(Some(None)) } else { Ok(Some(Some(Avatar::Url(s)))) } } Some(AvatarOrString::Avatar(a)) => Ok(Some(Some(a))), } } #[derive(Debug, Clone, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct Persona { pub id: String, pub display_name: String, #[serde( default, skip_serializing_if = "Option::is_none", alias = "avatarUrl", deserialize_with = "deserialize_avatar_compat" )] pub avatar: Option, pub system_prompt: String, #[serde(skip_serializing_if = "Option::is_none")] pub provider: Option, #[serde(skip_serializing_if = "Option::is_none")] pub model: Option, pub is_builtin: bool, #[serde(default)] pub is_from_disk: bool, pub created_at: String, pub updated_at: String, } #[derive(Debug, Clone, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct CreatePersonaRequest { pub display_name: String, #[serde( default, skip_serializing_if = "Option::is_none", deserialize_with = "deserialize_avatar_compat" )] pub avatar: Option, pub system_prompt: String, #[serde(skip_serializing_if = "Option::is_none")] pub provider: Option, #[serde(skip_serializing_if = "Option::is_none")] pub model: Option, } #[derive(Debug, Clone, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct UpdatePersonaRequest { #[serde(skip_serializing_if = "Option::is_none")] pub display_name: Option, #[serde( default, skip_serializing_if = "Option::is_none", deserialize_with = "deserialize_avatar_update" )] pub avatar: Option>, #[serde(skip_serializing_if = "Option::is_none")] pub system_prompt: Option, #[serde(skip_serializing_if = "Option::is_none")] pub provider: Option, #[serde(skip_serializing_if = "Option::is_none")] pub model: Option, } #[allow(dead_code)] #[derive(Debug, Clone, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct Agent { pub id: String, pub name: String, #[serde(skip_serializing_if = "Option::is_none")] pub persona_id: Option, pub provider: String, pub model: String, #[serde(skip_serializing_if = "Option::is_none")] pub system_prompt: Option, pub connection_type: String, pub status: String, pub is_builtin: bool, #[serde(skip_serializing_if = "Option::is_none")] pub acp_endpoint: Option, pub created_at: String, pub updated_at: String, } #[derive(Debug, Clone, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct Session { pub id: String, pub title: String, #[serde(skip_serializing_if = "Option::is_none")] pub agent_id: Option, #[serde(skip_serializing_if = "Option::is_none", default)] pub project_id: Option, #[serde(skip_serializing_if = "Option::is_none", default)] pub provider_id: Option, #[serde(skip_serializing_if = "Option::is_none", default)] pub persona_id: Option, #[serde(skip_serializing_if = "Option::is_none", default)] pub model_name: Option, pub created_at: String, pub updated_at: String, pub message_count: u32, #[serde(skip_serializing_if = "Option::is_none")] pub last_message_preview: Option, #[serde(skip_serializing_if = "Option::is_none", default)] pub archived_at: Option, } /// Partial update for a session — only provided fields are applied. #[derive(Debug, Clone, Deserialize)] #[serde(rename_all = "camelCase")] pub struct SessionUpdate { pub title: Option, pub provider_id: Option, pub persona_id: Option, pub model_name: Option, #[serde(default, deserialize_with = "deserialize_nullable_field")] pub project_id: Option>, } fn deserialize_nullable_field<'de, D, T>(deserializer: D) -> Result>, D::Error> where D: Deserializer<'de>, T: Deserialize<'de>, { Option::>::deserialize(deserializer) } pub use super::builtin_personas::builtin_personas;