fix(openai): support gpt-5-nano parameters

Author: ChiragAgg5k

README.md

@@ -70,6 +70,7 @@ $openai = new OpenAI(
 ```
 
 Available OpenAI Models:
+- `MODEL_GPT_5_NANO`: GPT-5 Nano - Small GPT-5 variant optimized for low latency and cost-sensitive workloads
 - `MODEL_GPT_4_5_PREVIEW`: GPT-4.5 Preview - OpenAI's most advanced model with enhanced reasoning, broader knowledge, and improved instruction following
 - `MODEL_GPT_4_1`: GPT-4.1 - Advanced large language model with strong reasoning capabilities and improved context handling
 - `MODEL_GPT_4O`: GPT-4o - Multimodal model optimized for both text and image processing with faster response times
@@ -245,4 +246,4 @@ We truly ❤️ pull requests! If you wish to help, you can learn more about how
 
 ## Copyright and license
 
-The MIT License (MIT) [http://www.opensource.org/licenses/mit-license.php](http://www.opensource.org/licenses/mit-license.php) 
+The MIT License (MIT) [http://www.opensource.org/licenses/mit-license.php](http://www.opensource.org/licenses/mit-license.php) 

src/Agents/Adapters/OpenAI.php

@@ -11,6 +11,11 @@
 
 class OpenAI extends Adapter
 {
+    /**
+     * GPT-5 Nano - Small GPT-5 variant optimized for low latency and cost-sensitive workloads
+     */
+    public const MODEL_GPT_5_NANO = 'gpt-5-nano';
+
     /**
      * GPT-4.5 Preview - OpenAI's most advanced model with enhanced reasoning, broader knowledge, and improved instruction following
      */
@@ -76,6 +81,11 @@ class OpenAI extends Adapter
      */
     protected int $timeout;
 
+    /**
+     * @var bool
+     */
+    protected bool $hasWarnedTemperatureOverride = false;
+
     /**
      * Create a new OpenAI adapter
      *
@@ -164,8 +174,15 @@ public function send(array $messages, ?callable $listener = null): Message
         $payload = [
             'model' => $this->model,
             'messages' => $formattedMessages,
-            'temperature' => $this->temperature,
         ];
+        $temperature = $this->temperature;
+        if ($this->usesDefaultTemperatureOnly()) {
+            if ($this->temperature !== 1.0) {
+                $this->warnTemperatureOverride();
+            }
+            $temperature = 1.0;
+        }
+        $payload['temperature'] = $temperature;
 
         $schema = $this->getAgent()->getSchema();
         if ($schema !== null) {
@@ -187,13 +204,7 @@ public function send(array $messages, ?callable $listener = null): Message
             $payload['stream'] = true;
         }
 
-        // Use 'max_completion_tokens' for o-series models, else 'max_tokens'
-        $oSeriesModels = [
-            self::MODEL_O3,
-            self::MODEL_O3_MINI,
-            self::MODEL_O4_MINI,
-        ];
-        if (in_array($this->model, $oSeriesModels)) {
+        if ($this->usesMaxCompletionTokens()) {
             $payload['max_completion_tokens'] = $this->maxTokens;
         } else {
             $payload['max_tokens'] = $this->maxTokens;
@@ -306,6 +317,7 @@ protected function process(Chunk $chunk, ?callable $listener): string
     public function getModels(): array
     {
         return [
+            self::MODEL_GPT_5_NANO,
             self::MODEL_GPT_4_5_PREVIEW,
             self::MODEL_GPT_4_1,
             self::MODEL_GPT_4O,
@@ -315,6 +327,43 @@ public function getModels(): array
         ];
     }
 
+    /**
+     * OpenAI expects max_completion_tokens for these models.
+     */
+    protected function usesMaxCompletionTokens(): bool
+    {
+        return in_array($this->model, [
+            self::MODEL_GPT_5_NANO,
+            self::MODEL_O4_MINI,
+            self::MODEL_O3,
+            self::MODEL_O3_MINI,
+        ], true);
+    }
+
+    /**
+     * Some models only accept the default temperature (1).
+     */
+    protected function usesDefaultTemperatureOnly(): bool
+    {
+        return in_array($this->model, [
+            self::MODEL_GPT_5_NANO,
+        ], true);
+    }
+
+    protected function warnTemperatureOverride(): void
+    {
+        if ($this->hasWarnedTemperatureOverride) {
+            return;
+        }
+
+        $this->hasWarnedTemperatureOverride = true;
+        error_log(
+            "OpenAI adapter warning: model '{$this->model}' only supports temperature=1.0. "
+            ."Overriding provided value {$this->temperature}. "
+            .'Set temperature to 1.0 to remove this warning.'
+        );
+    }
+
     /**
      * Get current model
      *