""" ----------------------------------------------------------------------------------------- INTERSEL - 4 cité d'Hauteville - 75010 PARIS RCS PARIS 488 379 660 - NAF 721Z File : tools/resource/update_resource.py Object : UpdateResource tool for the MCP server ----------------------------------------------------------------------------------------- Modifications : - 2026/01/27 - Damien Lugagne-Delpon - V1.0.0 - Creation ----------------------------------------------------------------------------------------- @copyright : Intersel 2026 @author : Damien Lugagne-Delpon - damien.lugagne-delpon@livinweb.fr @version : 1.0.0 (to be updated to the current_version of the developed software if file is touched) ----------------------------------------------------------------------------------------- """ import logging from typing import Dict, Any import asyncio from mcp_server.tools.tool_class import Tool from mcp_server.api.modx_client import get_modx_client from mcp_server.config import settings from mcp_server.core.errors import ( ResourceNotFoundError, MODXAPIError, ValidationError, InternalError, ) logger = logging.getLogger(__name__) class UpdateResourceTool(Tool): """Outil pour mettre à jour une ressource MODX.""" def __init__(self): """Initialiser l'outil UpdateResource.""" super().__init__( name="update_resource", description="Update an existing resource in MODX.", remarks="The resource must be available in the context with update permission. " "Only provided fields will be updated; omitted fields remain unchanged.", parameters={ "id": { "required":True, "type":"integer", "description":"ID of the resource to update" }, "pagetitle": { "required":False, "type":"string", "description":"New page title", "default":None }, "content": { "required":False, "type":"string", "description":"New content", "default":None }, "published": { "required":False, "type":"boolean", "description":"Publication status", "default":None }, "tvs": { "required":False, "type":"object", "description":"Updated template variable values as {tv_name: value}", "default":{} }, "alias": { "required":False, "type":"string", "description":"New URL alias", "default":None }, } ) async def handler(self, **kwargs) -> Dict[str, Any]: """ Mettre à jour une ressource MODX. Returns: Dict avec structure {success, code, data, message} """ try: # Extraire les paramètres resource_id = kwargs.get("id") # Validation basique if not isinstance(resource_id, int) or resource_id <= 0: return { "success": False, "code": 400, "data": [], "message": "id must be a positive integer" } # Préparer les données à mettre à jour (seulement les champs fournis) resource_data = {"id": resource_id} # Ajouter les champs optionnels s'ils sont fournis if kwargs.get("pagetitle") is not None: resource_data["pagetitle"] = kwargs.get("pagetitle") if kwargs.get("content") is not None: resource_data["content"] = kwargs.get("content") if kwargs.get("published") is not None: resource_data["published"] = kwargs.get("published") if kwargs.get("alias") is not None: resource_data["alias"] = kwargs.get("alias") tvs = kwargs.get("tvs", {}) if tvs: resource_data["tvs"] = tvs # Vérifier qu'au moins un champ est à mettre à jour if len(resource_data) == 1: # Seulement l'id return { "success": False, "code": 400, "data": [], "message": "At least one field must be provided for update" } # Appeler l'API MODX logger.info(f"Updating resource: ID {resource_id}") client = get_modx_client() endpoint = settings.MODX_ENDPOINTS["resource"]["update"].format(id=resource_id) response = client.put(endpoint, resource_data) return { "success": response.get("success", False), "code": response.get("code", 500), "data": response.get("data", []), "message": response.get("message", "Resource update completed") } 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 update_resource: {str(e)}") return { "success": False, "code": 500, "data": [], "message": f"Internal error: {str(e)}" } # Instance globale de l'outil update_resource_tool = UpdateResourceTool()