use std::path::PathBuf;
use anyhow::Context;
use super::common;
use super::{exec_with_env, find_on_path, server};
pub(super) fn launch_pi(
model: &str,
reasons: bool,
vision: bool,
context_window: Option<u64>,
extra_args: &[String],
) -> anyhow::Result<()> {
let bin = find_on_path("pi").ok_or_else(|| anyhow::anyhow!("pi is not installed"))?;
write_pi_config(model, reasons, vision, context_window)?;
exec_with_env(&bin, extra_args, &[])
}
const PI_PROVIDER: &str = "llmman";
pub(super) fn pi_agent_dir() -> anyhow::Result<PathBuf> {
if let Some(dir) = common::configured_pi_agent_dir()? {
return Ok(dir);
}
Ok(crate::config::home_dir()
.context("no home directory")?
.join(".pi")
.join("agent"))
}
fn write_pi_config(
model: &str,
reasons: bool,
vision: bool,
context_window: Option<u64>,
) -> anyhow::Result<()> {
let dir = pi_agent_dir()?;
let entry = common::pi_model_entry(model, reasons, vision, context_window);
common::write_json_merged(&dir.join("models.json"), "pi", |existing| {
pi_models_merged(existing, &server(), &entry)
})?;
common::write_json_merged(&dir.join("settings.json"), "pi", |existing| {
pi_settings_merged(existing, model)
})
}
fn pi_models_merged(
existing: &serde_json::Value,
server: &str,
entry: &serde_json::Value,
) -> serde_json::Value {
common::provider_models_merged(existing, PI_PROVIDER, entry, false, |provider| {
provider.insert("baseUrl".into(), serde_json::json!(format!("{server}/v1")));
provider
.entry("api")
.or_insert_with(|| serde_json::json!("openai-completions"));
provider
.entry("apiKey")
.or_insert_with(|| serde_json::json!("llmman"));
})
}
fn pi_settings_merged(existing: &serde_json::Value, model: &str) -> serde_json::Value {
let mut root = existing.clone();
root["defaultProvider"] = serde_json::json!(PI_PROVIDER);
root["defaultModel"] = serde_json::json!(model);
root
}
#[cfg(test)]
mod tests {
use super::super::{env_dir, node_user_profile};
use super::common::pi_model_entry;
use super::*;
#[test]
fn pi_agent_dir_reads_the_home_node_reads() {
assert_eq!(
crate::config::home_dir(),
node_user_profile().or_else(dirs::home_dir)
);
if cfg!(windows) {
assert_eq!(node_user_profile(), env_dir("USERPROFILE"));
} else {
assert_eq!(node_user_profile(), None);
}
}
#[test]
fn pi_models_merged_keeps_other_providers_and_hand_added_models() {
let existing: serde_json::Value = serde_json::from_str(
r#"{
"providers": {
"other": { "baseUrl": "https://example.invalid/v1" },
"llmman": {
"headers": { "X-Trace": "1" },
"apiKey": "mine-not-yours",
"models": [{ "id": "mine" }, { "id": "stale" }]
}
}
}"#,
)
.unwrap();
let entry = pi_model_entry("qwen3.5:0.8b", false, false, None);
let merged = pi_models_merged(&existing, "http://127.0.0.1:17434", &entry);
assert_eq!(
merged["providers"]["other"]["baseUrl"],
"https://example.invalid/v1"
);
assert_eq!(
merged["providers"]["llmman"]["baseUrl"],
"http://127.0.0.1:17434/v1"
);
assert_eq!(merged["providers"]["llmman"]["headers"]["X-Trace"], "1");
assert_eq!(merged["providers"]["llmman"]["apiKey"], "mine-not-yours");
let ids: Vec<&str> = merged["providers"]["llmman"]["models"]
.as_array()
.unwrap()
.iter()
.map(|m| m["id"].as_str().unwrap())
.collect();
assert_eq!(ids, vec!["mine", "stale", "qwen3.5:0.8b"]);
}
#[test]
fn pi_models_merged_survives_a_wrong_shaped_providers_value() {
for raw in [r#"{"providers": []}"#, r#"{"providers": "x"}"#, r#"{}"#] {
let existing: serde_json::Value = serde_json::from_str(raw).unwrap();
let entry = pi_model_entry("m", false, false, None);
let merged = pi_models_merged(&existing, "http://s", &entry);
assert_eq!(merged["providers"]["llmman"]["baseUrl"], "http://s/v1");
assert_eq!(merged["providers"]["llmman"]["models"][0]["id"], "m");
}
}
#[test]
fn pi_models_merged_writes_the_placeholder_key_into_a_fresh_provider() {
let entry = pi_model_entry("m", false, false, None);
let merged = pi_models_merged(&serde_json::json!({}), "http://127.0.0.1:17434", &entry);
let provider = &merged["providers"]["llmman"];
assert_eq!(provider["baseUrl"], "http://127.0.0.1:17434/v1");
assert_eq!(provider["api"], "openai-completions");
assert_eq!(provider["apiKey"], "llmman");
}
#[test]
fn pi_models_merged_keeps_a_previously_launched_model() {
let first = pi_model_entry("a", false, false, None);
let one = pi_models_merged(&serde_json::json!({}), "http://s", &first);
let two = pi_models_merged(&one, "http://s", &pi_model_entry("b", false, false, None));
let ids: Vec<&str> = two["providers"]["llmman"]["models"]
.as_array()
.unwrap()
.iter()
.map(|m| m["id"].as_str().unwrap())
.collect();
assert_eq!(ids, vec!["a", "b"]);
}
#[test]
fn pi_settings_merged_leaves_unrelated_settings_alone() {
let existing = serde_json::json!({ "theme": "dark", "defaultModel": "old" });
let merged = pi_settings_merged(&existing, "qwen3.5:0.8b");
assert_eq!(merged["theme"], "dark");
assert_eq!(merged["defaultProvider"], "llmman");
assert_eq!(merged["defaultModel"], "qwen3.5:0.8b");
}
}