chore: rename conversations to root level item

Author: iBotPeaches

src/Client.php

@@ -15,6 +15,7 @@
 use OpenAI\Resources\Chat;
 use OpenAI\Resources\Completions;
 use OpenAI\Resources\Containers;
+use OpenAI\Resources\Conversations;
 use OpenAI\Resources\Edits;
 use OpenAI\Resources\Embeddings;
 use OpenAI\Resources\Files;
@@ -48,6 +49,16 @@ public function responses(): Responses
         return new Responses($this->transporter);
     }
 
+    /**
+     * Create and manage conversations to store and retrieve conversation state across Response API calls.
+     *
+     * @see https://platform.openai.com/docs/api-reference/conversations
+     */
+    public function conversations(): Conversations
+    {
+        return new Conversations($this->transporter);
+    }
+
     /**
      * Given a prompt, the model will return one or more predicted completions, and can also return the probabilities
      * of alternative tokens at each position.

src/Contracts/ClientContract.php

@@ -7,6 +7,7 @@
 use OpenAI\Contracts\Resources\BatchesContract;
 use OpenAI\Contracts\Resources\ChatContract;
 use OpenAI\Contracts\Resources\CompletionsContract;
+use OpenAI\Contracts\Resources\ConversationsContract;
 use OpenAI\Contracts\Resources\EditsContract;
 use OpenAI\Contracts\Resources\EmbeddingsContract;
 use OpenAI\Contracts\Resources\FilesContract;
@@ -37,6 +38,13 @@ public function completions(): CompletionsContract;
      */
     public function responses(): ResponsesContract;
 
+    /**
+     * Create and manage conversations to store and retrieve conversation state across Response API calls.
+     *
+     * @see https://platform.openai.com/docs/api-reference/conversations
+     */
+    public function conversations(): ConversationsContract;
+
     /**
      * Communicate with a GPT-4o class model in real time using WebRTC or WebSockets. Supports text and audio inputs and outputs, along with audio transcriptions.
      *

src/Contracts/Resources/ResponsesConversationsContract.php renamed to src/Contracts/Resources/ConversationsContract.php

@@ -4,10 +4,10 @@
 
 namespace OpenAI\Contracts\Resources;
 
-use OpenAI\Responses\Responses\Conversations\ConversationDeletedResponse;
-use OpenAI\Responses\Responses\Conversations\ConversationResponse;
+use OpenAI\Responses\Conversations\ConversationDeletedResponse;
+use OpenAI\Responses\Conversations\ConversationResponse;
 
-interface ResponsesConversationsContract
+interface ConversationsContract
 {
     /**
      * Create a conversation
@@ -46,5 +46,5 @@ public function delete(string $conversationId): ConversationDeletedResponse;
      *
      * @see https://platform.openai.com/docs/api-reference/conversations/list-items
      */
-    public function items(): ResponsesConversationsItemsContract;
+    public function items(): ConversationsItemsContract;
 }

src/Contracts/Resources/ResponsesConversationsItemsContract.php renamed to src/Contracts/Resources/ConversationsItemsContract.php

@@ -4,11 +4,11 @@
 
 namespace OpenAI\Contracts\Resources;
 
-use OpenAI\Responses\Responses\Conversations\ConversationItem;
-use OpenAI\Responses\Responses\Conversations\ConversationItemList;
-use OpenAI\Responses\Responses\Conversations\ConversationResponse;
+use OpenAI\Responses\Conversations\ConversationItem;
+use OpenAI\Responses\Conversations\ConversationItemList;
+use OpenAI\Responses\Conversations\ConversationResponse;
 
-interface ResponsesConversationsItemsContract
+interface ConversationsItemsContract
 {
     /**
      * Create items for a conversation

src/Resources/ResponsesConversations.php renamed to src/Resources/Conversations.php

@@ -4,18 +4,18 @@
 
 namespace OpenAI\Resources;
 
-use OpenAI\Contracts\Resources\ResponsesConversationsContract;
-use OpenAI\Contracts\Resources\ResponsesConversationsItemsContract;
-use OpenAI\Responses\Responses\Conversations\ConversationDeletedResponse;
-use OpenAI\Responses\Responses\Conversations\ConversationResponse;
+use OpenAI\Contracts\Resources\ConversationsContract;
+use OpenAI\Contracts\Resources\ConversationsItemsContract;
+use OpenAI\Responses\Conversations\ConversationDeletedResponse;
+use OpenAI\Responses\Conversations\ConversationResponse;
 use OpenAI\ValueObjects\Transporter\Payload;
 use OpenAI\ValueObjects\Transporter\Response;
 
 /**
  * @phpstan-import-type ConversationType from ConversationResponse
  * @phpstan-import-type ConversationDeletedType from ConversationDeletedResponse
  */
-final class ResponsesConversations implements ResponsesConversationsContract
+final class Conversations implements ConversationsContract
 {
     use Concerns\Transportable;
 
@@ -74,8 +74,8 @@ public function delete(string $conversationId): ConversationDeletedResponse
     /**
      * {@inheritdoc}
      */
-    public function items(): ResponsesConversationsItemsContract
+    public function items(): ConversationsItemsContract
     {
-        return new ResponsesConversationsItems($this->transporter);
+        return new ConversationsItems($this->transporter);
     }
 }

src/Resources/ResponsesConversationsItems.php renamed to src/Resources/ConversationsItems.php

@@ -4,10 +4,10 @@
 
 namespace OpenAI\Resources;
 
-use OpenAI\Contracts\Resources\ResponsesConversationsItemsContract;
-use OpenAI\Responses\Responses\Conversations\ConversationItem;
-use OpenAI\Responses\Responses\Conversations\ConversationItemList;
-use OpenAI\Responses\Responses\Conversations\ConversationResponse;
+use OpenAI\Contracts\Resources\ConversationsItemsContract;
+use OpenAI\Responses\Conversations\ConversationItem;
+use OpenAI\Responses\Conversations\ConversationItemList;
+use OpenAI\Responses\Conversations\ConversationResponse;
 use OpenAI\ValueObjects\Transporter\Payload;
 use OpenAI\ValueObjects\Transporter\Response;
 
@@ -16,7 +16,7 @@
  * @phpstan-import-type ConversationItemListType from ConversationItemList
  * @phpstan-import-type ConversationType from ConversationResponse
  */
-final class ResponsesConversationsItems implements ResponsesConversationsItemsContract
+final class ConversationsItems implements ConversationsItemsContract
 {
     use Concerns\Transportable;
 

src/Resources/Responses.php

@@ -5,7 +5,6 @@
 namespace OpenAI\Resources;
 
 use OpenAI\Contracts\Resources\ResponsesContract;
-use OpenAI\Contracts\Resources\ResponsesConversationsContract;
 use OpenAI\Responses\Responses\CreateResponse;
 use OpenAI\Responses\Responses\CreateStreamedResponse;
 use OpenAI\Responses\Responses\DeleteResponse;
@@ -127,14 +126,4 @@ public function list(string $id, array $parameters = []): ListInputItems
 
         return ListInputItems::from($response->data(), $response->meta());
     }
-
-    /**
-     * Manage the Conversations API under Responses.
-     *
-     * @see https://platform.openai.com/docs/api-reference/conversations
-     */
-    public function conversations(): ResponsesConversationsContract
-    {
-        return new ResponsesConversations($this->transporter);
-    }
 }

src/Responses/Responses/Conversations/ConversationDeletedResponse.php renamed to src/Responses/Conversations/ConversationDeletedResponse.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace OpenAI\Responses\Responses\Conversations;
+namespace OpenAI\Responses\Conversations;
 
 use OpenAI\Contracts\ResponseContract;
 use OpenAI\Contracts\ResponseHasMetaInformationContract;

src/Responses/Responses/Conversations/ConversationItem.php renamed to src/Responses/Conversations/ConversationItem.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace OpenAI\Responses\Responses\Conversations;
+namespace OpenAI\Responses\Conversations;
 
 use OpenAI\Contracts\ResponseContract;
 use OpenAI\Responses\Concerns\ArrayAccessible;

src/Responses/Responses/Conversations/ConversationItemList.php renamed to src/Responses/Conversations/ConversationItemList.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace OpenAI\Responses\Responses\Conversations;
+namespace OpenAI\Responses\Conversations;
 
 use OpenAI\Contracts\ResponseContract;
 use OpenAI\Contracts\ResponseHasMetaInformationContract;