docs: add AI Assistant resource and entities

Author: andrepimpao

docs/02-configuration.md

@@ -72,7 +72,7 @@ $api = new OpenWeatherMap('yourapikey', [
 > To get to know about all the available methods, make sure to check the documentation [here](https://github.com/programmatordev/php-api-sdk?tab=readme-ov-file#documentation).
 
 The following sections have examples of some of the most important methods, 
-particularly related with the configuration of the client, cache and logger.
+particularly related to the configuration of the client, cache and logger.
 
 ### `setClientBuilder`
 

docs/03-supported-apis.md

@@ -6,6 +6,9 @@
     - [getWeatherByDate](#getweatherbydate)
     - [getWeatherSummaryByDate](#getweathersummarybydate)
     - [getWeatherOverviewByDate](#getweatheroverviewbydate)
+  - [AI Assistant](#ai-assistant)
+    - [startSession](#startsession)
+    - [resumeSession](#resumesession)
   - [Weather](#weather)
     - [getCurrent](#getcurrent)
     - [getForecast](#getforecast)
@@ -84,6 +87,36 @@ Returns a [`WeatherOverview`](05-entities.md#weatheroverview) object:
 $weatherOverview = $api->oneCall()->getWeatherOverviewByDate(50, 50, new \DateTime('today'));
 ```
 
+### AI Assistant
+
+#### `startSession`
+
+```php
+startSession(string $prompt): Answer
+```
+
+Start a new session (create a new conversation) with the Weather AI Assistant.
+
+Returns a [`Answer`](05-entities.md#answer) object:
+
+```php
+$answer = $api->assistant()->startSession('How is the weather today in Lisbon?');
+```
+
+#### `resumeSession`
+
+```php
+resumeSession(string $sessionId, string $prompt): Answer
+```
+
+Resume a session (continue a conversation) with the Weather AI Assistant.
+
+Returns a [`Answer`](05-entities.md#answer) object:
+
+```php
+$answer = $api->assistant()->resumeSession('session-id', 'Do I need an umbrella?');
+```
+
 ### Weather
 
 #### `getCurrent`
@@ -192,7 +225,7 @@ $locations = $api->geocoding()->getByLocationName('lisbon');
 getByCoordinate(float $latitude, float $longitude, int $numResults = 5): array
 ```
 
-Get name of the location (city name or area name) by using geographical coordinates (latitude, longitude). 
+Get the name of the location (city name or area name) by using geographical coordinates (latitude, longitude). 
 
 Returns an array of [`Location`](05-entities.md#location) objects.
 
@@ -261,7 +294,7 @@ withCacheTtl(?int $ttl): self
 Makes a request and saves into cache for the provided duration in seconds. 
 
 Semantics of values:
-- `0`, the response will not be cached (if the servers specifies no `max-age`).
+- `0`, the response will not be cached (if the server specifies no `max-age`).
 - `null`, the response will be cached for as long as it can (forever).
 
 > [!NOTE]

docs/05-entities.md

@@ -4,17 +4,21 @@
   - [Weather](#weather)
   - [WeatherMoment](#weathermoment)
   - [WeatherSummary](#weathersummary)
+  - [WeatherOverview](#weatheroverview)
   - [WeatherData](#weatherdata)
   - [MinuteData](#minutedata)
   - [HourData](#hourdata)
   - [DayData](#daydata)
   - [Alert](#alert)
   - [MoonPhase](#moonphase)
   - [Temperature](#temperature)
+- [AI Assistant](#ai-assistant)
+  - [Answer](#answer)
+  - [WeatherData](#weatherdata-1)
 - [Weather](#weather-1)
   - [Weather](#weather-2)
   - [WeatherCollection](#weathercollection)
-  - [WeatherData](#weatherdata)
+  - [WeatherData](#weatherdata-2)
 - [Air Pollution](#air-pollution)
   - [AirPollution](#airpollution)
   - [AirPollutionCollection](#airpollutioncollection)
@@ -171,6 +175,33 @@
 - `getMin()`: `?float`
 - `getMax()`: `?float`
 
+## AI Assistant
+
+### Answer
+
+- `getAnswer()`: `string`
+- `getSessionId()`: `string`
+- `getData()`: [`WeatherData[]`](#weatherdata-1)
+
+### WeatherData
+
+- `getLocationName()`: `string`
+- `getDateTime()`: `\DateTimeImmutable`
+- `getTemperature()`: `float`
+- `getTemperatureFeelsLike()`: `float`
+- `getAtmosphericPressure()`: `int`
+- `getVisibility()`: `?int`
+- `getHumidity()`: `int`
+- `getDewPoint()`: `float`
+- `getUltraVioletIndex()`: `?float`
+- `getCloudiness()`: `int`
+- `getWind()`: [`Wind`](#wind)
+- `getConditions()`: [`Condition[]`](#condition)
+- `getRainVolume()`: `?float`
+- `getSnowVolume()`: `?float`
+- `getSunriseAt()`: `?\DateTimeImmutable`
+- `getSunsetAt()`: `?\DateTimeImmutable`
+
 ## Weather
 
 ### Weather

src/OpenWeatherMap.php

@@ -39,14 +39,14 @@ public function __construct(
         $this->configureApi();
     }
 
-    public function assistant(): AssistantResource
+    public function oneCall(): OneCallResource
     {
-        return new AssistantResource($this);
+        return new OneCallResource($this);
     }
 
-    public function oneCall(): OneCallResource
+    public function assistant(): AssistantResource
     {
-        return new OneCallResource($this);
+        return new AssistantResource($this);
     }
 
     public function weather(): WeatherResource

src/Resource/AssistantResource.php

@@ -10,7 +10,7 @@
 class AssistantResource extends Resource
 {
     /**
-     * Start a new session (create a news conversation) with the Weather AI Assistant
+     * Start a new session (create a new conversation) with the Weather AI Assistant
      *
      * @throws ClientExceptionInterface
      */