Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors
Rust
feat(mcp): support compact option in memory_install_self_routing (#675 follow-up)
evanmaranzanoa5b9363ba290
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex ffce67e8..9d41b293 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -41,6 +41,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0find it), the untrusted-history security scaffold, and the cross-harnessmemory-of-record guidance; `full_block` and the default remain unchanged.(#675)+- `memory_install_self_routing` accepts `compact: Option<bool>` so agent-driven+ refreshes of a compact-installed file preserve the compact routing block+ instead of rewriting it back to full.### Fixed- Wiki auto-commits stage what the wiki wrote instead of walking thediff --git a/crates/ai-memory-core/src/routing_skills/ai-memory-routing-install/SKILL.md b/crates/ai-memory-core/src/routing_skills/ai-memory-routing-install/SKILL.mdindex b6c288d5..e46d3beb 100644--- a/crates/ai-memory-core/src/routing_skills/ai-memory-routing-install/SKILL.md+++ b/crates/ai-memory-core/src/routing_skills/ai-memory-routing-install/SKILL.md@@ -10,7 +10,7 @@ Use this skill when the user wants ai-memory's agent-facing routing instructions## Tools in this cluster-- `memory_install_self_routing` returns the canonical markered instruction block, marker strings, filename hints, notes, and managed skill payloads for agents that cannot let the MCP server write the host filesystem directly.+- `memory_install_self_routing` returns the canonical markered instruction block, marker strings, filename hints, notes, and managed skill payloads for agents that cannot let the MCP server write the host filesystem directly. Pass `compact: true` when managed Agent Skills are installed or when refreshing a file that already uses the compact snippet.## Managed instruction marker@@ -50,6 +50,6 @@ Use platform-aware path joining. Do not build paths by string concatenation.## Refresh guidance-For an agent-side refresh, call the install-routing tool. Its returned `target_hints` are authoritative for skill roots: choose the right instruction filename from `agent_filenames`, write the markered block with the agent's file-edit tool, and write each managed skill file below the selected hint using its `relative_path`. Claude Code normally uses `CLAUDE.md` and `.claude/skills`; Codex, OpenCode, Cursor, Gemini CLI, and AGENTS-aware clients normally use `AGENTS.md` and `.agents/skills`; Grok Build CLI uses `AGENTS.md` and `.grok/skills` unless the project says otherwise.+For an agent-side refresh, call the install-routing tool (pass `compact: true` if the target file already uses the compact snippet or if managed Agent Skills handle detailed routing). Its returned `target_hints` are authoritative for skill roots: choose the right instruction filename from `agent_filenames`, write the markered block with the agent's file-edit tool, and write each managed skill file below the selected hint using its `relative_path`. Claude Code normally uses `CLAUDE.md` and `.claude/skills`; Codex, OpenCode, Cursor, Gemini CLI, and AGENTS-aware clients normally use `AGENTS.md` and `.agents/skills`; Grok Build CLI uses `AGENTS.md` and `.grok/skills` unless the project says otherwise.For a CLI refresh, prefer the canonical install command. The snippet and skills must be updated from the same core-owned assets so they do not drift.diff --git a/crates/ai-memory-mcp/src/server.rs b/crates/ai-memory-mcp/src/server.rsindex b07f8ef1..227f9572 100644--- a/crates/ai-memory-mcp/src/server.rs+++ b/crates/ai-memory-mcp/src/server.rs@@ -1125,6 +1125,14 @@ struct ExploreArgs {#[serde(default)]workspace: Option<String>,}+#[derive(Debug, Default, Serialize, Deserialize, schemars::JsonSchema)]+struct InstallSelfRoutingArgs {+ /// Return the compact routing block instead of full operational guidance.+ /// Use when managed Agent Skills are installed or when refreshing a file that+ /// already uses the compact snippet.+ #[serde(default)]+ compact: Option<bool>,+}// The "you MUST pass exactly one of path/query" contract lives in the// field descriptions and the runtime validation, NOT in a root-level@@ -3968,8 +3976,11 @@ impl AiMemoryServer {`markered_block` for the slim CLAUDE.md / AGENTS.md snippet, \`agent_filenames` for rules-file targets, `managed_skills` for \Agent Skill files, and `target_hints` for project/global \- `.claude/skills`, `.agents/skills`, `.devin/skills`, `.grok/skills`, `$GROK_HOME/skills` (default `~/.grok/skills`), and Devin Windows global roots. Use when the user \- asks to install or refresh ai-memory routing in this project. \+ `.claude/skills`, `.agents/skills`, `.devin/skills`, `.grok/skills`, \+ `$GROK_HOME/skills` (default `~/.grok/skills`), and Devin Windows global roots. \+ Use when the user asks to install or refresh ai-memory routing in this project. \+ Pass `compact: true` to return the compact routing block that delegates \+ to installed Agent Skills, or when refreshing a file that already uses the compact snippet. \After calling, use your Write/Edit tool to preserve non-ai-memory \user content: replace only an existing `<!-- ai-memory:start -->` \/ `<!-- ai-memory:end -->` block whose delimiters appear alone on \@@ -3981,7 +3992,10 @@ impl AiMemoryServer {managed marker; do not overwrite unmanaged same-name skills unless \the human explicitly forces replacement.")]- async fn memory_install_self_routing(&self) -> Result<CallToolResult, McpError> {+ async fn memory_install_self_routing(+ &self,+ Parameters(args): Parameters<InstallSelfRoutingArgs>,+ ) -> Result<CallToolResult, McpError> {let managed_skills: Vec<_> = ai_memory_core::routing_skills::MANAGED_SKILLS.iter().map(|skill| {@@ -3993,8 +4007,15 @@ impl AiMemoryServer {})}).collect();+ let is_compact = args.compact.unwrap_or(false);+ let markered_block = if is_compact {+ ai_memory_core::compact_block()+ } else {+ ai_memory_core::full_block()+ };let response = serde_json::json!({- "markered_block": ai_memory_core::full_block(),+ "markered_block": markered_block,+ "compact": is_compact,"marker_start": ai_memory_core::MARKER_START,"marker_end": ai_memory_core::MARKER_END,"agent_filenames": {@@ -4037,6 +4058,7 @@ impl AiMemoryServer {"notes": ["Pick the filename matching your own agent identity.","If the target file already contains <!-- ai-memory:start --> / <!-- ai-memory:end --> delimiters alone on their own lines, replace ONLY that line-delimited block in place; ignore inline mentions and preserve every other line.",+ "If the target file already uses the compact routing block (or if managed Agent Skills handle detailed routing), call memory_install_self_routing with compact: true so the compact format is preserved.","If the file doesn't exist, create it with just the markered_block (plus a trailing newline).","If the file exists but has no ai-memory markers, append the markered_block with one blank line of separation from existing content.","Install each managed_skills item under the selected skill root from target_hints using its relative_path, for example .claude/skills/<relative_path>, .agents/skills/<relative_path>, .devin/skills/<relative_path>, .grok/skills/<relative_path>, $GROK_HOME/skills/<relative_path> (default ~/.grok/skills), or %APPDATA%\\devin\\skills\\<relative_path> on Windows global Devin installs.",@@ -5725,7 +5747,13 @@ mod tests {async fn memory_install_self_routing_response_includes_managed_skills_and_targets() {let (_tmp, _store, server, _ws, _pj) = setup_server().await;- let response = call_tool_json(server.memory_install_self_routing().await.unwrap());+ let response = call_tool_json(+ server+ .memory_install_self_routing(Parameters(InstallSelfRoutingArgs::default()))+ .await+ .unwrap(),+ );+ assert!(!response["compact"].as_bool().unwrap());assert_eq!(response["markered_block"].as_str().unwrap(),@@ -5882,6 +5910,25 @@ mod tests {assert!(notes.contains("%APPDATA%\\devin\\skills"));assert!(notes.contains("explicitly forces replacement"));}+ #[tokio::test]+ async fn memory_install_self_routing_compact_returns_compact_block() {+ let (_tmp, _store, server, _ws, _pj) = setup_server().await;++ let response = call_tool_json(+ server+ .memory_install_self_routing(Parameters(InstallSelfRoutingArgs {+ compact: Some(true),+ }))+ .await+ .unwrap(),+ );++ assert_eq!(+ response["markered_block"].as_str().unwrap(),+ ai_memory_core::compact_block()+ );+ assert!(response["compact"].as_bool().unwrap());+ }#[tokio::test]async fn memory_install_self_routing_tool_description_covers_snippet_and_skills() {@@ -5916,6 +5963,10 @@ mod tests {desc.contains("unmanaged same-name skills") && desc.contains("explicitly forces"),"tool description must mention safe overwrite behavior; got: {desc}");+ assert!(+ desc.contains("compact: true"),+ "tool description must mention compact option; got: {desc}"+ );}#[test]