""" Outil pour créer une ressource MODX. """ import logging from typing import Dict, Any import asyncio from mcp_server.tools.tool_class import Tool, ToolParameter from mcp_server.api.modx_client import get_modx_client from mcp_server.config import settings from mcp_server.core.constants import ModxType, actionType from mcp_server.core.permissions import check_permission from mcp_server.core.errors import ( ValidationError, PermissionError, MODXAPIError, InternalError, ) logger = logging.getLogger(__name__) class CreateResourceTool(Tool): """Outil pour créer une ressource MODX.""" def __init__(self): """Initialiser l'outil CreateResource.""" super().__init__( name="create_resource", description="Create a new resource in MODX with specified template and properties.", remarks="The template must be available in the context with read permission. " "Use get_template to understand template structure before creation.", parameters={ "pagetitle": ToolParameter( required=True, type="string", description="Page title of the resource" ), "template": ToolParameter( required=True, type="integer", description="Template ID to use for the resource" ), "content": ToolParameter( required=False, type="string", description="Main content of the resource", default="" ), "parent": ToolParameter( required=False, type="integer", description="Parent resource ID (0 for root)", default=0 ), "published": ToolParameter( required=False, type="boolean", description="Publish the resource", default=False ), "tvs": ToolParameter( required=False, type="object", description="Template variable values as {tv_name: value}", default={} ), "alias": ToolParameter( required=False, type="string", description="URL alias for the resource", default="" ), } ) async def handler(self, **kwargs) -> Dict[str, Any]: """ Créer une ressource MODX. Returns: Dict avec structure {success, code, data, message} """ try: # Extraire les paramètres pagetitle = kwargs.get("pagetitle") template_id = kwargs.get("template") content = kwargs.get("content", "") parent = kwargs.get("parent", 0) published = kwargs.get("published", False) tvs = kwargs.get("tvs", {}) alias = kwargs.get("alias", "") # Validation basique if not pagetitle or not isinstance(pagetitle, str): return { "success": False, "code": 400, "data": [], "message": "pagetitle is required and must be a string" } if not isinstance(template_id, int) or template_id <= 0: return { "success": False, "code": 400, "data": [], "message": "template must be a positive integer" } # Préparer les données pour l'API resource_data = { "pagetitle": pagetitle, "template": template_id, "content": content, "parent": parent, "published": published, } if alias: resource_data["alias"] = alias if tvs: resource_data["tvs"] = tvs # Appeler l'API MODX logger.info(f"Creating resource: {pagetitle}") client = get_modx_client() endpoint = settings.MODX_ENDPOINTS["resource"]["create"] response = client.post(endpoint, resource_data) # Ajouter la ressource créée au contexte if response.get("success") and "data" in response: created_resource = response["data"] if isinstance(created_resource, dict) and "id" in created_resource: # La ressource est créée avec droits read et update # Cela sera géré par le client MCP/l'agent logger.info(f"Resource created successfully: ID {created_resource['id']}") return { "success": response.get("success", False), "code": response.get("code", 500), "data": response.get("data", []), "message": response.get("message", "Resource creation completed") } except PermissionError as e: logger.warning(f"Permission denied: {e.message}") return { "success": False, "code": e.code, "data": [], "message": e.message } except MODXAPIError as e: logger.error(f"MODX API error: {e.message}") return { "success": False, "code": e.code, "data": [], "message": e.message } except ValidationError as e: logger.error(f"Validation error: {e.message}") return { "success": False, "code": e.code, "data": [], "message": e.message } except Exception as e: logger.error(f"Unexpected error in create_resource: {str(e)}") return { "success": False, "code": 500, "data": [], "message": f"Internal error: {str(e)}" } # Instance globale de l'outil create_resource_tool = CreateResourceTool()