to_array(), $context ); } /** * Validate that the resource is unique within the MCP server. * * @param \GoDaddy\WordPress\Plugins\AiroWp\Dependencies\WP\MCP\Domain\Prompts\McpPrompt $prompt The resource instance to validate. * @param string $context Optional context for error messages. * * @return bool|\WP_Error True if unique, WP_Error if the prompt name is not unique. */ public static function validate_prompt_uniqueness( McpPrompt $prompt, string $context = '' ) { $this_prompt_name = $prompt->get_name(); $existing_resource = $prompt->get_mcp_server()->get_prompt( $this_prompt_name ); if ( $existing_resource ) { $error_message = $context ? "[{$context}] " : ''; $error_message .= sprintf( /* translators: %s is the prompt name */ __( "Prompt name '%s' is not unique. It already exists in the MCP server.", 'mcp-adapter' ), $this_prompt_name ); return new \WP_Error( 'prompt_not_unique', esc_html( $error_message ) ); } return true; } /** * Get validation error details for debugging purposes. * This is the core validation method - all other validation methods use this. * * @param array $prompt_data The prompt data to validate. * * @return array Array of validation errors, empty if valid. */ public static function get_validation_errors( array $prompt_data ): array { $errors = array(); // Sanitize string inputs if ( isset( $prompt_data['name'] ) && is_string( $prompt_data['name'] ) ) { $prompt_data['name'] = trim( $prompt_data['name'] ); } if ( isset( $prompt_data['title'] ) && is_string( $prompt_data['title'] ) ) { $prompt_data['title'] = trim( $prompt_data['title'] ); } if ( isset( $prompt_data['description'] ) && is_string( $prompt_data['description'] ) ) { $prompt_data['description'] = trim( $prompt_data['description'] ); } // Check required fields if ( empty( $prompt_data['name'] ) || ! is_string( $prompt_data['name'] ) || ! McpValidator::validate_tool_or_prompt_name( $prompt_data['name'] ) ) { $errors[] = __( 'Prompt name is required and must only contain letters, numbers, hyphens (-), and underscores (_), and be 255 characters or less', 'mcp-adapter' ); } // Check optional fields if present if ( isset( $prompt_data['title'] ) && ! is_string( $prompt_data['title'] ) ) { $errors[] = __( 'Prompt title must be a string if provided', 'mcp-adapter' ); } if ( isset( $prompt_data['description'] ) && ! is_string( $prompt_data['description'] ) ) { $errors[] = __( 'Prompt description must be a string if provided', 'mcp-adapter' ); } // Validate arguments (optional field) if ( isset( $prompt_data['arguments'] ) ) { $arguments_errors = self::get_arguments_validation_errors( $prompt_data['arguments'] ); if ( ! empty( $arguments_errors ) ) { $errors = array_merge( $errors, $arguments_errors ); } } // Validate annotations structure if present. if ( isset( $prompt_data['annotations'] ) ) { if ( ! is_array( $prompt_data['annotations'] ) ) { $errors[] = __( 'Prompt annotations must be an array if provided', 'mcp-adapter' ); } else { $annotation_errors = McpValidator::get_annotation_validation_errors( $prompt_data['annotations'] ); if ( ! empty( $annotation_errors ) ) { $errors = array_merge( $errors, $annotation_errors ); } } } return $errors; } /** * Get detailed validation errors for prompt arguments. * * @param array|mixed $arguments The arguments to validate. * * @return array Array of validation errors, empty if valid. */ private static function get_arguments_validation_errors( $arguments ): array { $errors = array(); // Arguments must be an array if ( ! is_array( $arguments ) ) { return array( __( 'Prompt arguments must be an array if provided', 'mcp-adapter' ) ); } // Validate each argument foreach ( $arguments as $index => $argument ) { if ( ! is_array( $argument ) ) { $errors[] = sprintf( /* translators: %d: argument index */ __( 'Prompt argument at index %d must be an object', 'mcp-adapter' ), $index ); continue; } // Check required name field if ( empty( $argument['name'] ) || ! is_string( $argument['name'] ) ) { $errors[] = sprintf( /* translators: %d: argument index */ __( 'Prompt argument at index %d must have a non-empty name string', 'mcp-adapter' ), $index ); continue; } // Validate argument name format if ( ! McpValidator::validate_argument_name( $argument['name'] ) ) { $errors[] = sprintf( /* translators: %s: argument name */ __( 'Prompt argument \'%s\' name must only contain letters, numbers, hyphens (-), and underscores (_), and be 64 characters or less', 'mcp-adapter' ), $argument['name'] ); } // Check optional description field if ( isset( $argument['description'] ) && ! is_string( $argument['description'] ) ) { $errors[] = sprintf( /* translators: %s: argument name */ __( 'Prompt argument \'%s\' description must be a string if provided', 'mcp-adapter' ), $argument['name'] ); } // Check optional required field if ( ! isset( $argument['required'] ) || is_bool( $argument['required'] ) ) { continue; } $errors[] = sprintf( /* translators: %s: argument name */ __( 'Prompt argument \'%s\' required field must be a boolean if provided', 'mcp-adapter' ), $argument['name'] ); } return $errors; } /** * Validate prompt messages array (used when getting a prompt with messages). * * @param array $messages The messages to validate. * * @return array Array of validation errors, empty if valid. */ public static function validate_prompt_messages( array $messages ): array { $errors = array(); foreach ( $messages as $index => $message ) { if ( ! is_array( $message ) ) { $errors[] = sprintf( /* translators: %d: message index */ __( 'Message at index %d must be an object', 'mcp-adapter' ), $index ); continue; } // Check the required role field if ( empty( $message['role'] ) || ! is_string( $message['role'] ) ) { $errors[] = sprintf( /* translators: %d: message index */ __( 'Message at index %d must have a role field', 'mcp-adapter' ), $index ); continue; } // Validate role value if ( ! in_array( $message['role'], array( 'user', 'assistant' ), true ) ) { $errors[] = sprintf( /* translators: %d: message index */ __( 'Message at index %d role must be either \'user\' or \'assistant\'', 'mcp-adapter' ), $index ); } // Check the required content field if ( empty( $message['content'] ) || ! is_array( $message['content'] ) ) { $errors[] = sprintf( /* translators: %d: message index */ __( 'Message at index %d must have a content object', 'mcp-adapter' ), $index ); continue; } // Validate content $content_errors = self::get_content_validation_errors( $message['content'], $index ); if ( empty( $content_errors ) ) { continue; } $errors = array_merge( $errors, $content_errors ); } return $errors; } /** * Get validation errors for message content. * * @param array $content The content to validate. * @param int $message_index The message index for error reporting. * * @return array Array of validation errors, empty if valid. */ private static function get_content_validation_errors( array $content, int $message_index ): array { $errors = array(); // Check the required type field if ( empty( $content['type'] ) || ! is_string( $content['type'] ) ) { return array( sprintf( /* translators: %d: message index */ __( 'Message %d content must have a type field', 'mcp-adapter' ), $message_index ), ); } $type = $content['type']; switch ( $type ) { case 'text': if ( empty( $content['text'] ) || ! is_string( $content['text'] ) ) { $errors[] = sprintf( /* translators: %d: message index */ __( 'Message %d text content must have a non-empty text field', 'mcp-adapter' ), $message_index ); } break; case 'image': if ( empty( $content['data'] ) || ! is_string( $content['data'] ) ) { $errors[] = sprintf( /* translators: %d: message index */ __( 'Message %d image content must have a data field with base64-encoded image', 'mcp-adapter' ), $message_index ); } elseif ( ! McpValidator::validate_base64( $content['data'] ) ) { $errors[] = sprintf( /* translators: %d: message index */ __( 'Message %d image content data must be valid base64', 'mcp-adapter' ), $message_index ); } if ( empty( $content['mimeType'] ) || ! is_string( $content['mimeType'] ) ) { $errors[] = sprintf( /* translators: %d: message index */ __( 'Message %d image content must have a mimeType field', 'mcp-adapter' ), $message_index ); } elseif ( ! McpValidator::validate_image_mime_type( $content['mimeType'] ) ) { $errors[] = sprintf( /* translators: %d: message index */ __( 'Message %d image content must have a valid image MIME type', 'mcp-adapter' ), $message_index ); } break; case 'audio': if ( empty( $content['data'] ) || ! is_string( $content['data'] ) ) { $errors[] = sprintf( /* translators: %d: message index */ __( 'Message %d audio content must have a data field with base64-encoded audio', 'mcp-adapter' ), $message_index ); } elseif ( ! McpValidator::validate_base64( $content['data'] ) ) { $errors[] = sprintf( /* translators: %d: message index */ __( 'Message %d audio content data must be valid base64', 'mcp-adapter' ), $message_index ); } if ( empty( $content['mimeType'] ) || ! is_string( $content['mimeType'] ) ) { $errors[] = sprintf( /* translators: %d: message index */ __( 'Message %d audio content must have a mimeType field', 'mcp-adapter' ), $message_index ); } elseif ( ! McpValidator::validate_audio_mime_type( $content['mimeType'] ) ) { $errors[] = sprintf( /* translators: %d: message index */ __( 'Message %d audio content must have a valid audio MIME type', 'mcp-adapter' ), $message_index ); } break; case 'resource': if ( empty( $content['resource'] ) || ! is_array( $content['resource'] ) ) { $errors[] = sprintf( /* translators: %d: message index */ __( 'Message %d resource content must have a resource object', 'mcp-adapter' ), $message_index ); } else { // Validate embedded resource using the resource validator for strict MCP compliance. $resource_errors = McpResourceValidator::get_validation_errors( $content['resource'] ); foreach ( $resource_errors as $resource_error ) { $errors[] = sprintf( /* translators: %1$d: message index, %2$s: resource error */ __( 'Message %1$d embedded resource: %2$s', 'mcp-adapter' ), $message_index, $resource_error ); } } break; default: $errors[] = sprintf( /* translators: %1$d: message index, %2$s: content type */ __( 'Message %1$d content type \'%2$s\' is not supported. Must be \'text\', \'image\', \'audio\', or \'resource\'', 'mcp-adapter' ), $message_index, $type ); break; } // Check optional annotations if ( isset( $content['annotations'] ) ) { if ( ! is_array( $content['annotations'] ) ) { $errors[] = sprintf( /* translators: %d: message index */ __( 'Message %d content annotations must be an array if provided', 'mcp-adapter' ), $message_index ); } else { $annotation_errors = McpValidator::get_annotation_validation_errors( $content['annotations'] ); if ( ! empty( $annotation_errors ) ) { $errors = array_merge( $errors, $annotation_errors ); } } } return $errors; } }