agent_permissions, agent_term and subagent_term take their wire contracts from swarm-wire

swarm-wire/src/lib.rs

@@ -9,10 +9,50 @@ pub mod agent_icon;
 pub mod agent_inference;
 pub mod agent_limits;
 pub mod agent_login;
+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 notices;
 pub mod review_classifier;
+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.*");
+    }
+}