Open source Grok Bot alternative, Bring your own agent and subscription: message Claude Code, Codex, Gemini CLI, Cursor, Copilot and 40+ AI agents as bots on your own computer, from iPhone, Mac, Windows, Linux or terminal. Agent-agnostic and free. Also a Muse and Dots alternative. Built in Rust.
Rust acpagent-client-protocolai-agentsai-assistantclaudeclaude-codecodexcoding-agentscursorgeminigemini-cligrok-bot-alternativeiosiphonelinuxmacosmcpopen-sourcerustself-hosted
//! Phone/host compatibility: each side names the oldest version of the other it still works
//! with (docs/reference/compatibility.md). The host sends `MIN_APP` in `hello`; clients keep
//! their own oldest-host floor (`MIN_HOST` here for the terminal client).
use serde_json::Value;
/// The oldest client (iPhone, desktop app, terminal client) this host still serves correctly.
/// Raise it only when this host stops sending or accepting something older clients depend on;
/// the release gate (tools/release-gate.py) then offers the release once the App Store has that
/// iPhone app.
pub const MIN_APP: &str = "2.36.0";
/// The oldest host the terminal client works with.
pub const MIN_HOST: &str = "2.20.1";
/// Which side has to update before a client and a host can work together.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum Mismatch {
/// The client is older than the host's `minApp`.
UpdateApp { minimum: String },
/// The host is older than the client's floor.
UpdateHost { version: String, minimum: String },
}
/// `major.minor.patch`, ignoring a leading `v` and any pre-release or build suffix; missing
/// parts count as 0. `None` for anything else, which never blocks a connection.
fn parse(version: &str) -> Option<(u64, u64, u64)> {
let core = version.trim().trim_start_matches('v');
let core = core.split(['-', '+']).next()?;
let mut parts = core.split('.');
let mut next = |required: bool| match parts.next() {
Some(p) => p.parse::<u64>().ok(),
None if required => None,
None => Some(0),
};
let v = (next(true)?, next(false)?, next(false)?);
parts.next().is_none().then_some(v)
}
/// Whether `version` is below `minimum`; unreadable versions never are.
fn below(version: &str, minimum: &str) -> bool {
matches!((parse(version), parse(minimum)), (Some(v), Some(m)) if v < m)
}
/// Whether `version` is `minimum` or newer; unreadable versions count as newer.
pub fn at_least(version: &str, minimum: &str) -> bool {
!below(version, minimum)
}
/// Checks a client of version `app` with floor `min_host` against a host's `hello`.
/// Hosts that predate `minApp` only get the floor check.
pub fn check(app: &str, min_host: &str, hello: &Value) -> Option<Mismatch> {
if let Some(minimum) = hello["minApp"].as_str()
&& below(app, minimum)
{
return Some(Mismatch::UpdateApp { minimum: minimum.to_owned() });
}
let version = hello["version"].as_str().unwrap_or_default();
below(version, min_host).then(|| Mismatch::UpdateHost { version: version.to_owned(), minimum: min_host.to_owned() })
}
#[cfg(test)]
mod tests {
use super::*;
use serde_json::json;
#[test]
fn floors_never_exceed_this_release() {
// A floor above the version that ships it would lock out even matching builds.
let own = env!("CARGO_PKG_VERSION");
assert!(!below(own, MIN_APP), "MIN_APP {MIN_APP} is above {own}");
assert!(!below(own, MIN_HOST), "MIN_HOST {MIN_HOST} is above {own}");
assert!(parse(MIN_APP).is_some() && parse(MIN_HOST).is_some());
}
#[test]
fn parses_leniently() {
assert_eq!(parse("2.4.1"), Some((2, 4, 1)));
assert_eq!(parse(" v2.4 "), Some((2, 4, 0)));
assert_eq!(parse("3"), Some((3, 0, 0)));
assert_eq!(parse("2.4.0-beta.1+77"), Some((2, 4, 0)));
assert_eq!(parse("2.10.0").cmp(&parse("2.9.9")), std::cmp::Ordering::Greater);
for bad in ["", "abc", "2.x", "2.4.0.1", "-1.0.0", "2..0"] {
assert_eq!(parse(bad), None, "{bad}");
}
}
#[test]
fn unreadable_versions_never_block() {
assert!(!below("", "2.4.0"));
assert!(!below("2.0.0", "garbage"));
assert!(below("2.3.9", "2.4.0"));
assert!(!below("2.4.0", "2.4.0"));
assert!(!below("2.4.0-dev", "2.4.0"));
}
#[test]
fn decides_which_side_updates() {
let host = |version: &str, min_app: Option<&str>| {
let mut h = json!({"version": version});
if let Some(m) = min_app {
h["minApp"] = json!(m);
}
h
};
assert_eq!(check("2.4.0", "2.3.0", &host("2.4.0", Some("2.3.0"))), None);
assert_eq!(
check("2.4.0", "2.3.0", &host("2.6.0", Some("2.5.0"))),
Some(Mismatch::UpdateApp { minimum: "2.5.0".into() })
);
assert_eq!(
check("2.6.0", "2.5.0", &host("2.4.0", Some("2.3.0"))),
Some(Mismatch::UpdateHost { version: "2.4.0".into(), minimum: "2.5.0".into() })
);
// Older hosts send no minApp; only the floor applies.
assert_eq!(check("2.4.0", "2.3.0", &host("2.3.1", None)), None);
assert_eq!(
check("2.4.0", "2.3.0", &host("2.2.3", None)),
Some(Mismatch::UpdateHost { version: "2.2.3".into(), minimum: "2.3.0".into() })
);
// A hello without a version can't be judged.
assert_eq!(check("2.4.0", "2.3.0", &json!({})), None);
// A development client with no readable version isn't locked out.
assert_eq!(check("dev", "2.3.0", &host("2.6.0", Some("2.5.0"))), None);
}
}