use serde::{Deserialize, Serialize};
#[cfg(feature = "openapi")]
use utoipa::ToSchema;
pub const DEFAULT_PUBLIC_TOOL_ACTIVITY_TEXT: &str = "Working...";
#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq, Default)]
#[cfg_attr(feature = "openapi", derive(ToSchema))]
#[serde(rename_all = "snake_case")]
pub enum PublicToolVisibility {
None,
#[default]
Generic,
Narrated,
}
pub fn public_tool_activity_text(
visibility: PublicToolVisibility,
generic_tool_text: &str,
) -> Option<&str> {
match visibility {
PublicToolVisibility::None => None,
PublicToolVisibility::Generic | PublicToolVisibility::Narrated => {
let trimmed = generic_tool_text.trim();
Some(if trimmed.is_empty() {
DEFAULT_PUBLIC_TOOL_ACTIVITY_TEXT
} else {
trimmed
})
}
}
}
pub fn resolve_starters<'a>(
agent_starters: &'a [crate::ConversationStarter],
harness_starters: &'a [crate::ConversationStarter],
) -> &'a [crate::ConversationStarter] {
if agent_starters.is_empty() {
harness_starters
} else {
agent_starters
}
}
#[cfg(test)]
mod tests {
use super::*;
fn starter(text: &str) -> crate::ConversationStarter {
crate::ConversationStarter {
icon: None,
text: text.to_string(),
}
}
#[test]
fn resolve_starters_prefers_the_agent_then_falls_back_to_the_harness() {
let agent = vec![starter("Triage the newest P1")];
let harness = vec![starter("Summarize this channel")];
assert_eq!(
resolve_starters(&agent, &harness),
agent.as_slice(),
"an agent with starters must win over the harness"
);
assert_eq!(
resolve_starters(&[], &harness),
harness.as_slice(),
"an agent with no starters must inherit the harness ones"
);
assert!(
resolve_starters(&[], &[]).is_empty(),
"nothing authored must stay nothing"
);
}
#[test]
fn public_tool_activity_text_is_the_one_policy() {
assert_eq!(
public_tool_activity_text(PublicToolVisibility::None, "Reading the payroll table"),
None,
"None must expose nothing, including a configured string"
);
for visibility in [
PublicToolVisibility::Generic,
PublicToolVisibility::Narrated,
] {
assert_eq!(
public_tool_activity_text(visibility, "Looking that up"),
Some("Looking that up"),
"{visibility:?}"
);
assert_eq!(
public_tool_activity_text(visibility, " Looking that up "),
Some("Looking that up"),
"{visibility:?} must trim"
);
assert_eq!(
public_tool_activity_text(visibility, " "),
Some(DEFAULT_PUBLIC_TOOL_ACTIVITY_TEXT),
"{visibility:?} must fall back when the configured text is blank"
);
}
}
}