package p.studio.app.mcp; import com.fasterxml.jackson.databind.JsonNode; import com.fasterxml.jackson.databind.ObjectMapper; import com.fasterxml.jackson.databind.module.SimpleModule; import com.fasterxml.jackson.databind.ser.std.ToStringSerializer; import p.studio.api.automation.ProjectKnowledge; import java.nio.file.Path; import java.util.Map; import java.util.function.Function; /** Context reads need authentication at transport level, but no control grant or task. */ public final class McpProjectKnowledgeTools { private McpProjectKnowledgeTools() {} public static Map> handlers(ProjectKnowledge knowledge, ObjectMapper mapper) { // Jackson's default Path serializer produces file: URIs; the public contract uses absolute paths. var paths = new SimpleModule().addSerializer(Path.class, new ToStringSerializer()); var wireMapper = mapper.copy().registerModule(paths); return Map.of("studio_project_context", arguments -> McpToolResult.success(mapper, wireMapper.valueToTree(knowledge.context(Path.of(arguments.path("projectRoot").asText())))), "studio_reference_read", arguments -> McpToolResult.success(mapper, wireMapper.valueToTree( knowledge.readReference(Path.of(arguments.path("projectRoot").asText()), arguments.path("referenceId").asText(), integer(arguments, "offset", 0), integer(arguments, "limit", 4000))))); } private static int integer(JsonNode arguments, String name, int fallback) { var value = arguments.get(name); if (value == null) return fallback; if (!value.isIntegralNumber() || !value.canConvertToInt()) throw new IllegalArgumentException("Invalid " + name); return value.intValue(); } }