yoi/crates/pod/src/interrupt_prep.rs

109 lines
3.7 KiB
Rust

//! Pre-run cleanup that fires when a Pod transitions out of `Paused`
//! into a fresh turn via new user input.
//!
//! The previously in-flight turn is treated as finished. Any orphan
//! `Item::ToolCall` (tool_use emitted by the LLM but whose tool did not
//! run to completion before the pause) is closed with a synthetic
//! `Item::ToolResult` so the next request is wire-valid under providers
//! that require every `tool_use` to be followed by a matching
//! `tool_result` (Anthropic). A short system note is then inserted so
//! the LLM understands the prior work was cut short. Both side effects
//! happen at the front of `Pod::run` when
//! `worker.last_run_interrupted()` is set; see `Pod::apply_interrupt_prep`.
use llm_worker::Item;
#[cfg(test)]
use crate::prompt::catalog::PromptCatalog;
/// Build synthetic `Item::ToolResult` items for every unanswered
/// `Item::ToolCall` in `history`, preserving order.
pub(crate) fn orphan_tool_result_closures(history: &[Item], summary: &str) -> Vec<Item> {
let mut answered: std::collections::HashSet<&str> = std::collections::HashSet::new();
for item in history {
if let Item::ToolResult { call_id, .. } = item {
answered.insert(call_id.as_str());
}
}
let mut out = Vec::new();
for item in history {
if let Item::ToolCall { call_id, .. } = item {
if !answered.contains(call_id.as_str()) {
out.push(Item::tool_result(call_id.clone(), summary));
}
}
}
out
}
/// Test-only helper to surface the canonical interrupt tool-result
/// summary without round-tripping through a Pod — used by tests in
/// this module that validate the closure logic.
#[cfg(test)]
fn interrupt_tool_result_summary() -> String {
PromptCatalog::builtins_only()
.unwrap()
.interrupt_tool_result_summary()
.unwrap()
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn no_orphans_returns_empty() {
let history = vec![Item::user_message("hi"), Item::assistant_message("hello")];
let summary = interrupt_tool_result_summary();
assert!(orphan_tool_result_closures(&history, &summary).is_empty());
}
#[test]
fn paired_call_and_result_is_not_orphan() {
let history = vec![
Item::tool_call("c1", "Read", "{}"),
Item::tool_result("c1", "ok"),
];
let summary = interrupt_tool_result_summary();
assert!(orphan_tool_result_closures(&history, &summary).is_empty());
}
#[test]
fn unanswered_call_becomes_closure() {
let history = vec![Item::tool_call("c1", "Read", "{}")];
let summary = interrupt_tool_result_summary();
let out = orphan_tool_result_closures(&history, &summary);
assert_eq!(out.len(), 1);
match &out[0] {
Item::ToolResult {
call_id,
summary: got,
..
} => {
assert_eq!(call_id, "c1");
assert_eq!(got, &summary);
}
other => panic!("expected ToolResult, got {other:?}"),
}
}
#[test]
fn multiple_orphans_are_closed_in_order() {
let history = vec![
Item::tool_call("c1", "Read", "{}"),
Item::tool_call("c2", "Write", "{}"),
Item::tool_result("c1", "ok"),
Item::tool_call("c3", "Grep", "{}"),
];
let summary = interrupt_tool_result_summary();
let out = orphan_tool_result_closures(&history, &summary);
let ids: Vec<&str> = out
.iter()
.map(|i| match i {
Item::ToolResult { call_id, .. } => call_id.as_str(),
_ => unreachable!(),
})
.collect();
assert_eq!(ids, vec!["c2", "c3"]);
}
}