1. 1//! Retired tool registry.
2. 2//!
3. 3//! When a tool is removed from the agent's callable interface, its name
4. 4//! enters `RETIRED_TOOLS` so that plugin skill descriptions, prompt text,
5. 5//! or cached session data referencing it can be detected and cleaned up.
6. 6//!
7. 7//! A retired tool name may appear in:
8. 8//! - A skill `SKILL.md` body/description that still instructs the model to
9. 9//! call it (the `python_eval` / `react_preview` hallucination class).
10. 10//! - A stale `[plugins] network_allow` entry in `.vak/config.toml`.
11. 11//! - A cached `TurnCapabilitiesBound` entry in a session ledger.
12. 12//!
13. 13//! The cleanup pass in `vak_core::seed` and `PluginStore::retired_plugins`
14. 14//! consults this list. Each entry carries the last version in which the
15. 15//! tool was available and the replacement instruction for migration.
16. 16
17. 17/// A single retired tool reference with migration context.
18. 18#[derive(Debug, Clone, PartialEq, Eq)]
19. 19pub struct RetiredTool {
20. 20 /// The exact tool name the model might try to call.
21. 21 pub name: &'static str,
22. 22 /// The AGENTS.md version when the tool was removed.
23. 23 pub retired_in: &'static str,
24. 24 /// Replacement: what the model should use instead.
25. 25 pub replacement: &'static str,
26. 26}
27. 27
28. 28/// The compiled-in list of retired tool names, ordered by retirement date.
29. 29pub const RETIRED_TOOLS: &[RetiredTool] = &[
30. 30 RetiredTool {
31. 31 name: "python_eval",
32. 32 retired_in: "3.0.21",
33. 33 replacement: "bash — run Python via the `bash` tool (e.g. `python3 script.py`)",
34. 34 },
35. 35 RetiredTool {
36. 36 name: "react_preview",
37. 37 retired_in: "3.0.21",
38. 38 replacement: "bash — run React/preview tooling via the `bash` tool",
39. 39 },
40. 40];
41. 41
42. 42/// Returns `true` if `name` matches a retired tool (case-insensitive).
43. 43pub fn is_retired(name: &str) -> bool {
44. 44 RETIRED_TOOLS
45. 45 .iter()
46. 46 .any(|tool| tool.name.eq_ignore_ascii_case(name))
47. 47}
48. 48
49. 49/// Returns the replacement instruction for `name`, if it is retired.
50. 50pub fn replacement_for(name: &str) -> Option<&'static str> {
51. 51 RETIRED_TOOLS
52. 52 .iter()
53. 53 .find(|tool| tool.name.eq_ignore_ascii_case(name))
54. 54 .map(|tool| tool.replacement)
55. 55}
56. 56
57. 57/// Returns all retired tool names as a `Vec<&str>`.
58. 58pub fn retired_names() -> Vec<&'static str> {
59. 59 RETIRED_TOOLS.iter().map(|t| t.name).collect()
60. 60}
61. 61
62. 62#[cfg(test)]
63. 63mod tests {
64. 64 use super::*;
65. 65
66. 66 #[test]
67. 67 fn python_eval_is_retired() {
68. 68 assert!(is_retired("python_eval"));
69. 69 assert!(is_retired("python_eval"));
70. 70 assert!(!is_retired("bash"));
71. 71 }
72. 72
73. 73 #[test]
74. 74 fn react_preview_is_retired() {
75. 75 assert!(is_retired("react_preview"));
76. 76 assert!(!is_retired("read"));
77. 77 }
78. 78
79. 79 #[test]
80. 80 fn replacement_is_not_empty() {
81. 81 for tool in RETIRED_TOOLS {
82. 82 assert!(
83. 83 !tool.replacement.is_empty(),
84. 84 "{} must have a non-empty replacement",
85. 85 tool.name
86. 86 );
87. 87 }
88. 88 }
89. 89
90. 90 #[test]
91. 91 fn no_duplicate_retired_names() {
92. 92 let names: Vec<_> = RETIRED_TOOLS.iter().map(|t| t.name).collect();
93. 93 let unique: std::collections::HashSet<_> = names.iter().collect();
94. 94 assert_eq!(names.len(), unique.len(), "duplicate retired tool names");
95. 95 }
96. 96}
97. 97