e5c55257f8
the harness writes the reason into the pause marker when it pauses itself and reports it as paused_by_hive in its turn-state header. swarm-controller declares such an agent paused (only if declared up) and shows the reason on the agents status row and the swarm ui card.
69 lines
2.2 KiB
Rust
69 lines
2.2 KiB
Rust
//! The request and reply shapes swarm services exchange over the queue: the
|
|
//! subjects, their deadlines and the serde types that travel each way.
|
|
//!
|
|
//! Serde only, with no queue client and no secret-store client. A crate that
|
|
//! names a contract (the sender, the answerer, the auth-callout responder that
|
|
//! grants the subject) depends on this one without linking either.
|
|
|
|
pub mod agent_archetype;
|
|
pub mod agent_closures;
|
|
pub mod agent_icon;
|
|
pub mod agent_inference;
|
|
pub mod agent_limits;
|
|
pub mod agent_login;
|
|
pub mod agent_pause;
|
|
pub mod agent_permissions;
|
|
pub mod agent_schedules;
|
|
pub mod agent_status;
|
|
pub mod agent_term;
|
|
pub mod builder;
|
|
pub mod claude_login;
|
|
pub mod egress_allow;
|
|
pub mod forge_events;
|
|
pub mod hive_status;
|
|
pub mod notices;
|
|
pub mod notify_flows;
|
|
pub mod notify_router;
|
|
pub mod review_classifier;
|
|
pub mod router_api;
|
|
pub mod router_sink;
|
|
pub mod router_todo;
|
|
pub mod subagent_term;
|
|
pub mod wanted;
|
|
|
|
/// The subject `agent` publishes its terminal rows on. One leaf per agent, so
|
|
/// a subscriber can follow one agent without filtering the swarm's whole
|
|
/// terminal traffic.
|
|
///
|
|
/// Shared by the publisher (`hive-agent`), the relay that streams it to
|
|
/// swarm-ui (`swarm-controller`) and the queue's subscribe grant for readers
|
|
/// (`swarm-nats-auth`), which spells [`term_subject_wildcard`] — so a rename
|
|
/// moves all three together.
|
|
#[must_use]
|
|
pub fn term_subject(agent: &str) -> String {
|
|
format!("{TERM_SUBJECT_PREFIX}.{agent}")
|
|
}
|
|
|
|
/// Every [`term_subject`] at once: the reader's subscribe grant, which has no
|
|
/// roster to enumerate agents from.
|
|
#[must_use]
|
|
pub fn term_subject_wildcard() -> String {
|
|
term_subject("*")
|
|
}
|
|
|
|
/// Shared by [`term_subject`] and [`subagent_term`], whose subjects sit under
|
|
/// the same prefix.
|
|
pub const TERM_SUBJECT_PREFIX: &str = "$SWARM.term";
|
|
|
|
#[cfg(test)]
|
|
mod tests {
|
|
use super::*;
|
|
|
|
/// The names the publishers, the relays and the queue's grant all spell.
|
|
#[test]
|
|
fn term_subjects_are_the_agreed_names() {
|
|
assert_eq!(term_subject("mara"), "$SWARM.term.mara");
|
|
assert_eq!(term_subject_wildcard(), "$SWARM.term.*");
|
|
assert_eq!(subagent_term::subject_wildcard(), "$SWARM.term.*.sub.*");
|
|
}
|
|
}
|