Add conversational search

src/Client.php

@@ -5,7 +5,9 @@
 namespace Meilisearch;
 
 use Meilisearch\Endpoints\Batches;
+use Meilisearch\Endpoints\ChatWorkspaces;
 use Meilisearch\Endpoints\Delegates\HandlesBatches;
+use Meilisearch\Endpoints\Delegates\HandlesChatWorkspaces;
 use Meilisearch\Endpoints\Delegates\HandlesDumps;
 use Meilisearch\Endpoints\Delegates\HandlesIndex;
 use Meilisearch\Endpoints\Delegates\HandlesKeys;
@@ -31,6 +33,7 @@
 
 class Client
 {
+    use HandlesChatWorkspaces;
     use HandlesDumps;
     use HandlesIndex;
     use HandlesTasks;
@@ -53,6 +56,7 @@ public function __construct(
         ?StreamFactoryInterface $streamFactory = null
     ) {
         $this->http = new MeilisearchClientAdapter($url, $apiKey, $httpClient, $requestFactory, $clientAgents, $streamFactory);
+        $this->chats = new ChatWorkspaces($this->http);
         $this->index = new Indexes($this->http);
         $this->health = new Health($this->http);
         $this->version = new Version($this->http);

src/Contracts/ChatWorkspaceSettings.php

@@ -0,0 +1,88 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Meilisearch\Contracts;
+
+class ChatWorkspaceSettings extends Data
+{
+    private ?string $source;
+    private ?string $orgId;
+    private ?string $projectId;
+    private ?string $apiVersion;
+    private ?string $deploymentId;
+    private ?string $baseUrl;
+    private ?string $apiKey;
+    private array $prompts;
+
+    public function __construct(array $params)
+    {
+        parent::__construct($params);
+
+        $this->source = $params['source'] ?? null;
+        $this->orgId = $params['orgId'] ?? null;
+        $this->projectId = $params['projectId'] ?? null;
+        $this->apiVersion = $params['apiVersion'] ?? null;
+        $this->deploymentId = $params['deploymentId'] ?? null;
+        $this->baseUrl = $params['baseUrl'] ?? null;
+        $this->apiKey = $params['apiKey'] ?? null;
+        $this->prompts = $params['prompts'] ?? [];
+    }
+
+    public function getSource(): ?string
+    {
+        return $this->source;
+    }
+
+    public function getOrgId(): ?string
+    {
+        return $this->orgId;
+    }
+
+    public function getProjectId(): ?string
+    {
+        return $this->projectId;
+    }
+
+    public function getApiVersion(): ?string
+    {
+        return $this->apiVersion;
+    }
+
+    public function getDeploymentId(): ?string
+    {
+        return $this->deploymentId;
+    }
+
+    public function getBaseUrl(): ?string
+    {
+        return $this->baseUrl;
+    }
+
+    public function getApiKey(): ?string
+    {
+        return $this->apiKey;
+    }
+
+    /**
+     * @return array{system?: string, searchDescription?: string, searchQParam?: string, searchIndexUidParam?: string}
+     */
+    public function getPrompts(): array
+    {
+        return $this->prompts;
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'source' => $this->source,
+            'orgId' => $this->orgId,
+            'projectId' => $this->projectId,
+            'apiVersion' => $this->apiVersion,
+            'deploymentId' => $this->deploymentId,
+            'baseUrl' => $this->baseUrl,
+            'apiKey' => $this->apiKey,
+            'prompts' => $this->prompts,
+        ];
+    }
+}

src/Contracts/ChatWorkspacesResults.php

@@ -0,0 +1,59 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Meilisearch\Contracts;
+
+class ChatWorkspacesResults extends Data
+{
+    private int $offset;
+    private int $limit;
+    private int $total;
+
+    public function __construct(array $params)
+    {
+        parent::__construct($params['results'] ?? []);
+
+        $this->offset = $params['offset'];
+        $this->limit = $params['limit'];
+        $this->total = $params['total'] ?? 0;
+    }
+
+    /**
+     * @return array<int, array{uid: string}>
+     */
+    public function getResults(): array
+    {
+        return $this->data;
+    }
+
+    public function getOffset(): int
+    {
+        return $this->offset;
+    }
+
+    public function getLimit(): int
+    {
+        return $this->limit;
+    }
+
+    public function getTotal(): int
+    {
+        return $this->total;
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'results' => $this->data,
+            'offset' => $this->offset,
+            'limit' => $this->limit,
+            'total' => $this->total,
+        ];
+    }
+
+    public function count(): int
+    {
+        return \count($this->data);
+    }
+}

src/Contracts/Http.php

@@ -46,4 +46,10 @@ public function patch(string $path, $body = null, array $query = []);
      * @throws JsonDecodingException
      */
     public function delete(string $path, array $query = []);
+
+    /**
+     * @throws ApiException
+     * @throws JsonEncodingException
+     */
+    public function postStream(string $path, $body = null, array $query = []): \Psr\Http\Message\StreamInterface;
 }

src/Endpoints/ChatWorkspaces.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Meilisearch\Endpoints;
+
+use Meilisearch\Contracts\ChatWorkspacesResults;
+use Meilisearch\Contracts\Endpoint;
+use Meilisearch\Contracts\Http;
+use Meilisearch\Endpoints\Delegates\HandlesChatWorkspaceSettings;
+
+class ChatWorkspaces extends Endpoint
+{
+    use HandlesChatWorkspaceSettings;
+
+    protected const PATH = '/chats';
+
+    private ?string $workspaceName;
+
+    public function __construct(Http $http, ?string $workspaceName = null)
+    {
+        $this->workspaceName = $workspaceName;
+        parent::__construct($http);
+    }
+
+    public function listWorkspaces(): ChatWorkspacesResults
+    {
+        $response = $this->http->get(self::PATH);
+
+        return new ChatWorkspacesResults($response);
+    }
+
+    public function workspace(string $workspaceName): self
+    {
+        return new self($this->http, $workspaceName);
+    }
+}

src/Endpoints/Delegates/HandlesChatWorkspaceSettings.php

@@ -0,0 +1,88 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Meilisearch\Endpoints\Delegates;
+
+use Meilisearch\Contracts\ChatWorkspaceSettings;
+
+trait HandlesChatWorkspaceSettings
+{
+    /**
+     * Get the current settings for this chat workspace.
+     */
+    public function getSettings(): ChatWorkspaceSettings
+    {
+        if (null === $this->workspaceName) {
+            throw new \InvalidArgumentException('Workspace name is required to get settings');
+        }
+
+        $response = $this->http->get('/chats/'.$this->workspaceName.'/settings');
+
+        return new ChatWorkspaceSettings($response);
+    }
+
+    /**
+     * Update the settings for this chat workspace.
+     *
+     * @param array{
+     *     source?: 'openAi'|'azureOpenAi'|'mistral'|'gemini'|'vLlm',
+     *     orgId?: string,
+     *     projectId?: string,
+     *     apiVersion?: string,
+     *     deploymentId?: string,
+     *     baseUrl?: string,
+     *     apiKey?: string,
+     *     prompts?: array{
+     *         system?: string,
+     *         searchDescription?: string,
+     *         searchQParam?: string,
+     *         searchIndexUidParam?: string
+     *     }
+     * } $settings
+     */
+    public function updateSettings(array $settings): ChatWorkspaceSettings
+    {
+        if (null === $this->workspaceName) {
+            throw new \InvalidArgumentException('Workspace name is required to update settings');
+        }
+
+        $response = $this->http->patch('/chats/'.$this->workspaceName.'/settings', $settings);
+
+        return new ChatWorkspaceSettings($response);
+    }
+
+    /**
+     * Reset the settings for this chat workspace to default values.
+     */
+    public function resetSettings(): ChatWorkspaceSettings
+    {
+        if (null === $this->workspaceName) {
+            throw new \InvalidArgumentException('Workspace name is required to reset settings');
+        }
+
+        $response = $this->http->delete('/chats/'.$this->workspaceName.'/settings');
+
+        return new ChatWorkspaceSettings($response);
+    }
+
+    /**
+     * Create a streaming chat completion.
+     *
+     * @param array{
+     *     model: string,
+     *     messages: array<array{role: string, content: string}>,
+     *     stream: bool,
+     *     temperature?: float,
+     *     max_tokens?: int
+     * } $options
+     */
+    public function streamCompletion(array $options): \Psr\Http\Message\StreamInterface
+    {
+        if (null === $this->workspaceName) {
+            throw new \InvalidArgumentException('Workspace name is required for chat completion');
+        }
+
+        return $this->http->postStream('/chats/'.$this->workspaceName.'/chat/completions', $options);
+    }
+}

src/Endpoints/Delegates/HandlesChatWorkspaces.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Meilisearch\Endpoints\Delegates;
+
+use Meilisearch\Contracts\ChatWorkspacesResults;
+use Meilisearch\Endpoints\ChatWorkspaces;
+
+trait HandlesChatWorkspaces
+{
+    public ChatWorkspaces $chats;
+
+    /**
+     * List all chat workspaces.
+     */
+    public function getChatWorkspaces(): ChatWorkspacesResults
+    {
+        return $this->chats->listWorkspaces();
+    }
+
+    /**
+     * Get a specific chat workspace instance.
+     */
+    public function chatWorkspace(string $workspaceName): ChatWorkspaces
+    {
+        return $this->chats->workspace($workspaceName);
+    }
+}