lean_ctx/tools/registered/
ctx_pack.rs1use rmcp::ErrorData;
2use rmcp::model::Tool;
3use serde_json::{Map, Value, json};
4
5use crate::server::tool_trait::{
6 McpTool, ToolContext, ToolOutput, get_bool, get_int, get_str, get_str_array, get_usize,
7};
8use crate::tool_defs::tool_def;
9
10pub struct CtxPackTool;
11
12impl McpTool for CtxPackTool {
13 fn name(&self) -> &'static str {
14 "ctx_pack"
15 }
16
17 fn tool_def(&self) -> Tool {
18 tool_def(
19 "ctx_pack",
20 "WORKFLOW: create -> export -> import -> install for sharing context state.\n\
21 ANTIPATTERN: NOT for ephemeral session save (use ctx_session).\n\
22 Context Package Manager — create, install, manage portable context packages\n\
23 with knowledge, graph, session patterns, and gotchas.\n\
24 Actions: pr, create, list, info, remove, install, export, import, auto_load, summary.\n\
25 Saves tokens: pre-built context state (avoids re-building).",
26 json!({
27 "type": "object",
28 "properties": {
29 "action": {
30 "type": "string",
31 "enum": ["pr", "create", "list", "info", "remove", "install", "export", "import", "auto_load", "summary"],
32 "description": "Pack action to perform"
33 },
34 "project_root": {
35 "type": "string",
36 "description": "Project root directory"
37 },
38 "name": {
39 "type": "string",
40 "description": "Package name"
41 },
42 "version": {
43 "type": "string",
44 "description": "Package version (semver)"
45 },
46 "description": {
47 "type": "string",
48 "description": "Package description (for create)"
49 },
50 "author": {
51 "type": "string",
52 "description": "Package author (for create)"
53 },
54 "tags": {
55 "type": "array",
56 "items": { "type": "string" },
57 "description": "Tags for categorization (for create)"
58 },
59 "layers": {
60 "type": "array",
61 "items": { "type": "string" },
62 "description": "Layers to include: knowledge|graph|session|patterns|gotchas"
63 },
64 "level": {
65 "type": "integer",
66 "description": "Detail level 1-3 (higher = more detail)"
67 },
68 "scope": {
69 "type": "string",
70 "description": "Package scope (e.g. @org/name)"
71 },
72 "base": {
73 "type": "string",
74 "description": "Git base ref for PR diff"
75 },
76 "format": {
77 "type": "string",
78 "enum": ["markdown", "json"],
79 "description": "Output format: markdown|json"
80 },
81 "depth": {
82 "type": "integer",
83 "description": "Impact depth for pr action (default: 3)"
84 },
85 "diff": {
86 "type": "string",
87 "description": "Git diff --name-status text input"
88 },
89 "file": {
90 "type": "string",
91 "description": "File path for import/export"
92 },
93 "apply": {
94 "type": "boolean",
95 "description": "Apply after import (default: false)"
96 },
97 "enable": {
98 "type": "boolean",
99 "description": "Enable auto-load (default: true)"
100 }
101 },
102 "required": ["action"]
103 }),
104 )
105 }
106
107 fn handle(
108 &self,
109 args: &Map<String, Value>,
110 ctx: &ToolContext,
111 ) -> Result<ToolOutput, ErrorData> {
112 let action = get_str(args, "action")
113 .ok_or_else(|| ErrorData::invalid_params("action is required", None))?;
114
115 let project_root = if let Some(p) = ctx
116 .resolved_path("project_root")
117 .or(ctx.resolved_path("root"))
118 {
119 p.to_string()
120 } else if let Some(err) = ctx.path_error("project_root").or(ctx.path_error("root")) {
121 return Err(ErrorData::invalid_params(
122 format!("project_root: {err}"),
123 None,
124 ));
125 } else {
126 ctx.project_root.clone()
127 };
128
129 let result = match action.as_str() {
130 "pr" => {
131 let base = get_str(args, "base");
132 let format = get_str(args, "format");
133 let depth = get_usize(args, "depth").map(|d| d.min(64));
134 let diff = get_str(args, "diff");
135 crate::tools::ctx_pack::handle(
136 "pr",
137 &project_root,
138 base.as_deref(),
139 format.as_deref(),
140 depth,
141 diff.as_deref(),
142 )
143 }
144 "create" => {
145 let name = get_str(args, "name")
146 .ok_or_else(|| ErrorData::invalid_params("name is required for create", None))?;
147 let version = get_str(args, "version");
148 let description = get_str(args, "description");
149 let author = get_str(args, "author");
150 let tags = get_str_array(args, "tags");
151 let layers = get_str_array(args, "layers");
152 let level = get_int(args, "level").and_then(|l| u32::try_from(l).ok());
153 let scope = get_str(args, "scope");
154 crate::tools::ctx_pack::handle_create(
155 &project_root,
156 &name,
157 version.as_deref(),
158 description.as_deref(),
159 author.as_deref(),
160 tags.as_deref(),
161 layers.as_deref(),
162 level,
163 scope.as_deref(),
164 )
165 }
166 "list" => crate::tools::ctx_pack::handle_list(),
167 "info" => {
168 let name = get_str(args, "name")
169 .ok_or_else(|| ErrorData::invalid_params("name is required for info", None))?;
170 let version = get_str(args, "version");
171 crate::tools::ctx_pack::handle_info(&name, version.as_deref())
172 }
173 "remove" => {
174 let name = get_str(args, "name")
175 .ok_or_else(|| ErrorData::invalid_params("name is required for remove", None))?;
176 let version = get_str(args, "version");
177 crate::tools::ctx_pack::handle_remove(&name, version.as_deref())
178 }
179 "install" => {
180 let name = get_str(args, "name").ok_or_else(|| {
181 ErrorData::invalid_params("name is required for install", None)
182 })?;
183 let version = get_str(args, "version");
184 crate::tools::ctx_pack::handle_install(&name, version.as_deref(), &project_root)
185 }
186 "export" => {
187 let name = get_str(args, "name").ok_or_else(|| {
188 ErrorData::invalid_params("name is required for export", None)
189 })?;
190 let version = get_str(args, "version");
191 let file = get_str(args, "file");
192 crate::tools::ctx_pack::handle_export(&name, version.as_deref(), file.as_deref())
193 }
194 "import" => {
195 let file = get_str(args, "file")
196 .ok_or_else(|| ErrorData::invalid_params("file is required for import", None))?;
197 let apply = get_bool(args, "apply").unwrap_or(false);
198 crate::tools::ctx_pack::handle_import(&file, apply, &project_root)
199 }
200 "auto_load" => {
201 let name = get_str(args, "name");
202 let version = get_str(args, "version");
203 let enable = get_bool(args, "enable").unwrap_or(true);
204 crate::tools::ctx_pack::handle_auto_load(
205 name.as_deref(),
206 version.as_deref(),
207 enable,
208 )
209 }
210 "summary" => crate::tools::ctx_pack::handle_summary(&project_root),
211 _ => "Unknown action. Use: pr, create, list, info, remove, install, export, import, auto_load, summary".to_string(),
212 };
213
214 Ok(ToolOutput::simple(result))
215 }
216}