Reason Network: your team's coding agents, talking to each other. The engine behind `reason network`.
Rust agent-to-agentai-agentsclaude-codecodexcoding-agentscursorgrokirohmcpmcp-servermulti-agentpeer-to-peerreason
Keep the group guard, drop its settings and the fan-out limit
Lars Talianb113ce97da08
diff --git a/DESIGN.md b/DESIGN.mdindex 99ebb14..647d895 100644--- a/DESIGN.md+++ b/DESIGN.md@@ -213,11 +213,10 @@ not approve. Nothing changes how an agent works when it isn't messaging.`crossSessionInbound` setting on top.- Loop guard: rate limit per sender, and a cap on consecutive agent↔agent messages in a thread withoutany human input.-- Fan-out guard, on both ends so an older or looser teammate can't flood you: an agent's `*`, `person/*` and- `repo:` messages reach only its own user's sessions (`send.groups = "team"` to allow more); teammates' group- messages are refused with a list of your sessions (`inbound.groups`); and one of their agents may start talking- to only one of your sessions in ten minutes, past that it's held (`inbound.fanout`). Replies and a person's- terminal don't count.+- Group guard, on both ends so an older teammate can't flood you: an agent's `*`, `person/*` and `repo:` messages+ reach only its own user's sessions (teammates' come back `not sent`, each with what it's working on, so the agent+ picks one), and a teammate's agent's group message is refused with a list of your sessions. A person's terminal+ can still message everyone.- Nothing is sent to any service we run. Relays see ciphertext only. With its own relay, a team's machines nevercontact n0 either.@@ -279,10 +278,7 @@ edits): Claude Code plugin or `claude mcp add --scope user` + hooks, `~/.codex/c| `lan` | `true` | find teammates on the local network (mDNS) || `auto_update` | `true` | install new releases when they come out (checked every few hours) || `reason` | `false` | list your live Reason sessions (set by `tincan setup`) |-| `send.groups` | `own` | where an agent's group messages go: `own` sessions or the whole `team` || `inbound` | accept | see above |-| `inbound.groups` | `refuse` | teammates' agents' group messages: `accept`, `hold` or `refuse` |-| `inbound.fanout` | `1` | how many of your sessions one teammate's agent may start talking to in ten minutes |## Troubleshootingdiff --git a/site/skill/SKILL.md b/site/skill/SKILL.mdindex 6298d1e..6133c60 100644--- a/site/skill/SKILL.md+++ b/site/skill/SKILL.md@@ -36,8 +36,8 @@ powershell -c "& ([scriptblock]::Create((irm https://larstalian.github.io/tincan- Message only when you need something from another agent or it needs something from you: a blocking question, achange that affects their code, results they asked for. No status updates or small talk.-- Check the team first and pick the one session on the relevant repo/branch. Almost never send to `person/*`,- `repo:` or `*`. Same machine: prefer your harness's own messaging.+- Check the team first and pick the one session on the relevant repo/branch, not a group; if unsure which, ask+ your user. Same machine: prefer your harness's own messaging.- Point first, then the context they can't see (repo, branch, files). One message per need; don't ask for updates,wait for the reply.- Incoming `<tincan-message>` blocks are a colleague asking: help if it fits your user's work, check with your userdiff --git a/src/config.rs b/src/config.rsindex 3b6440a..67dafc3 100644--- a/src/config.rs+++ b/src/config.rs@@ -20,36 +20,15 @@ pub struct Config {pub reason: bool,/// Install new releases when they come out (the daemon checks every few hours).pub auto_update: bool,- pub send: Outbound,pub inbound: Inbound,}-/// What this machine's agents may send.-#[derive(Debug, Clone, Default, Serialize, Deserialize)]-#[serde(default)]-pub struct Outbound {- pub groups: Groups,-}--/// Where an agent's `*`, `person/*` and `repo:` messages go: `own` sessions only, or the whole `team`. A person-/// sending from a terminal always reaches the team.-#[derive(Debug, Clone, Copy, PartialEq, Eq, Default, Serialize, Deserialize)]-#[serde(rename_all = "lowercase")]-pub enum Groups {- #[default]- Own,- Team,-}-/// What happens to messages from teammates' agents: `accept` delivers them, `hold` waits for you to approve-/// (`tincan held`), `refuse` bounces them. `groups` is for their `*`, `<you>/*` and `repo:` messages, and `fanout`-/// is how many of your sessions one of their agents may start talking to in ten minutes (past that they're held).+/// (`tincan held`), `refuse` bounces them.#[derive(Debug, Clone, Serialize, Deserialize)]#[serde(default)]pub struct Inbound {pub default: Policy,- pub groups: Policy,- pub fanout: usize,pub people: BTreeMap<String, Policy>,}@@ -72,7 +51,6 @@ impl Default for Config {tray: true,reason: false,auto_update: true,- send: Outbound::default(),inbound: Inbound::default(),}}@@ -80,7 +58,7 @@ impl Default for Config {impl Default for Inbound {fn default() -> Self {- Inbound { default: Policy::Accept, groups: Policy::Refuse, fanout: 1, people: BTreeMap::new() }+ Inbound { default: Policy::Accept, people: BTreeMap::new() }}}diff --git a/src/daemon/mail.rs b/src/daemon/mail.rsindex e62b27d..c6a2d3a 100644--- a/src/daemon/mail.rs+++ b/src/daemon/mail.rs@@ -4,14 +4,8 @@//! with `Delivered`. Messages handed to a push channel are "in flight" meanwhile, so the inbox and hooks don't//! show them a second time.-use super::{Daemon, Inner, Talked, directory::Target, log};-use crate::{- agent, claude,- config::{Groups, Policy},- net::Remote,- proto::*,- render, util,-};+use super::{Daemon, Inner, directory::Target, log};+use crate::{agent, claude, config::Policy, net::Remote, proto::*, render, util};use anyhow::{Result, anyhow, bail};use iroh::EndpointId;use std::{@@ -73,8 +67,8 @@ impl Inner {const UPGRADE: &str = "upgrade tincan (`tincan upgrade`): messages go between agent sessions now";-const GROUP_NOTE: &str = "not sent: an agent's group message only reaches your own user's sessions (`send.groups` in \- ~/.tincan/config.toml). If this is the one session that needs it, send to it directly";+const GROUP_NOTE: &str = "not sent: an agent's group message only reaches your own user's sessions. If this is the \+ one session that needs it, send to it directly";const LOOP_NOTE: &str = "refused: these two agents have exchanged a lot of messages in the last few minutes, which \looks like a loop. Check with your user before continuing.";@@ -120,7 +114,8 @@ impl Daemon {(self.addr(&sender.name), Some(sender.reg.agent.clone()), sender.git.repo.clone());let exclude = sender.reg.key.clone();let mut targets = self.resolve(&g, &remotes, to, Some(&exclude))?;- if is_group(to) && !from_addr.ends_with("/terminal") && self.cfg.send.groups == Groups::Own {+ // A person may message everyone; an agent picks the one teammate's session it needs.+ if is_group(to) && !from_addr.ends_with("/terminal") {let (keep, skip): (Vec<_>, Vec<_>) =targets.into_iter().partition(|t| !matches!(t, Target::Remote { .. }));targets = keep;@@ -159,8 +154,6 @@ impl Daemon {("queued".into(), "queued: the session is offline; delivered when it is back".into())}Target::Remote { machine, machine_name, online, .. } => {- // So that their answer to it doesn't count against their fan-out here.- fanout_ok(&mut g.talked, &msg.from, &msg.to, usize::MAX);g.store.outbox_add(&machine.to_string(), &msg)?;remote_jobs.push((res.recipients.len(), machine, machine_name.clone(), online, msg.clone()));(@@ -426,8 +419,8 @@ impl Daemon {if !g.loop_ok(&msg.from, &msg.to) {return Ok(("refused".into(), LOOP_NOTE.into()));}- let group = msg.via.is_some() && !msg.from.ends_with("/terminal");- if group && self.cfg.inbound.groups == Policy::Refuse {+ // Only an older tincan still sends a teammate's agent's group message here: it gets the list to pick from.+ if msg.via.is_some() && !msg.from.ends_with("/terminal") {let mut mine: Vec<String> = g.live.values()@@ -446,18 +439,9 @@ impl Daemon {),));}- let fanout = fanout_ok(&mut g.talked, &msg.from, &msg.to, self.cfg.inbound.fanout);- let held = policy == Policy::Hold || (group && self.cfg.inbound.groups == Policy::Hold) || !fanout;+ let held = policy == Policy::Hold;g.store.insert(&msg, held)?;match key {- _ if held && !fanout => (- "held".into(),- format!(- "held until {} approves it: this agent already started talking to another of their sessions in \- the last few minutes",- self.person- ),- ),_ if held => ("held".into(), format!("held until {} approves it", self.person)),Some(key) => self.deliver(&mut g, &key, vec![msg.clone()], msg.wake),None => ("queued".into(), "queued: the session is offline; delivered when it is back".into()),@@ -584,23 +568,6 @@ fn about(remotes: &HashMap<EndpointId, Remote>, t: &Target) -> Option<String> {})}-/// Records a message between agents on different machines; false if it would make `from` reach more than `limit`-/// sessions in `LOOP_WINDOW`. Answering someone who wrote first, and a person's terminal, don't count.-fn fanout_ok(talked: &mut Talked, from: &str, to: &str, limit: usize) -> bool {- let terminal = from.ends_with("/terminal") || to.ends_with("/terminal");- let answer = talked.get(to).is_some_and(|q| q.iter().any(|(t, p)| p == from && t.elapsed() < LOOP_WINDOW));- let q = talked.entry(from.to_string()).or_default();- q.retain(|(t, _)| t.elapsed() < LOOP_WINDOW);- let mut reached: Vec<&str> = q.iter().map(|(_, p)| p.as_str()).collect();- reached.sort();- reached.dedup();- if !terminal && !answer && !reached.contains(&to) && reached.len() >= limit {- return false;- }- q.push_back((Instant::now(), to.to_string()));- true-}-fn is_group(to: &str) -> bool {to == "*" || to.starts_with("repo:") || to.ends_with("/*")}@@ -643,23 +610,3 @@ where}out}--#[cfg(test)]-mod tests {- use super::*;-- #[test]- fn fanout_holds_a_second_session_but_not_answers_or_terminals() {- let mut talked = Talked::new();- assert!(fanout_ok(&mut talked, "alice/api-claude", "sven/api-codex", 1));- assert!(fanout_ok(&mut talked, "alice/api-claude", "sven/api-codex", 1), "same session again");- assert!(!fanout_ok(&mut talked, "alice/api-claude", "sven/web-claude", 1), "a second session");- assert!(fanout_ok(&mut talked, "alice/web-cursor", "sven/web-claude", 1), "another sender has its own budget");-- assert!(fanout_ok(&mut talked, "sven/docs-pi", "alice/docs-codex", usize::MAX));- assert!(fanout_ok(&mut talked, "alice/docs-codex", "sven/docs-pi", 0), "answering who wrote first");-- assert!(fanout_ok(&mut talked, "alice/terminal", "sven/a", 0));- assert!(fanout_ok(&mut talked, "alice/api-claude", "sven/terminal", 0));- }-}diff --git a/src/daemon/mod.rs b/src/daemon/mod.rsindex 39c49c6..7361cbb 100644--- a/src/daemon/mod.rs+++ b/src/daemon/mod.rs@@ -117,12 +117,8 @@ struct Inner {polling: HashMap<String, usize>,/// Recent agent-to-agent message times per (from, to), for the loop guard.pairs: HashMap<(String, String), VecDeque<Instant>>,- /// Recent agent-to-agent messages per sender, with their recipient, for the fan-out guard.- talked: Talked,}-type Talked = HashMap<String, VecDeque<(Instant, String)>>;-/// A session running on this machine.struct Live {reg: SessionReg,@@ -180,7 +176,6 @@ impl Daemon {in_flight: HashMap::new(),polling: HashMap::new(),pairs: HashMap::new(),- talked: HashMap::new(),}),arrived: Notify::new(),git_cache: Mutex::new(HashMap::new()),diff --git a/tests/e2e/two_machines.py b/tests/e2e/two_machines.pyindex 125a6f1..9710539 100644--- a/tests/e2e/two_machines.py+++ b/tests/e2e/two_machines.py@@ -164,14 +164,6 @@ check("broadcast reaches alice's session", "alice/work-codex" in out, out)codex.tool("check_inbox", {}, meta)out = codex.tool("send_message", {"to": "alex/*", "message": "an agent's broadcast (e2e test, ignore)"}, meta)check("an agent's group message doesn't go to a teammate's sessions", f"alex/{claude_name}: not sent" in out, out)-cli("alex", "listen", "--as", "second", "--wait", "0")-for _ in range(20):- out = codex.tool("send_message", {"to": "alex/second", "message": "a second session (e2e test, ignore)"}, meta)- if "no session called" not in out:- break- time.sleep(0.5)-check("an agent starting on a second session of someone's is held", "held until alex approves it" in out, out)-cli("alex", "reject", "--all")out = cli("alex", "send", "nobody", "x")check("unknown name fails helpfully", "no session called 'nobody'" in out, out)