ref: make tools optional

Author: bernard-ng

src/Model/Completion/ChatInterface.php

@@ -22,7 +22,7 @@
  */
 interface ChatInterface
 {
-    public function completion(string $input, array $tools = []): string;
+    public function completion(string $input, ?array $tools = null): string;
 
-    public function completionWithHistory(string $input, History $history, array $tools = []): string;
+    public function completionWithHistory(string $input, History $history, ?array $tools = null): string;
 }

src/Model/Completion/CompletionChat.php

@@ -36,7 +36,7 @@ public function __construct(
      * @throws ServiceIntegrationException
      */
     #[\Override]
-    public function completion(string $input, array $tools = []): string
+    public function completion(string $input, ?array $tools = null): string
     {
         return $this->client->completion($input, $this->completionConfig, $tools)->completion;
     }
@@ -45,7 +45,7 @@ public function completion(string $input, array $tools = []): string
      * @throws ServiceIntegrationException
      */
     #[\Override]
-    public function completionWithHistory(string $input, History $history, array $tools = []): string
+    public function completionWithHistory(string $input, History $history, ?array $tools = null): string
     {
         $history->append(new Message($input, Role::USER));
 

src/Provider/Service/Client/DeepSeekClient.php

@@ -33,7 +33,7 @@ final class DeepSeekClient extends Client implements HasCompletionSupport
     protected Provider $provider = Provider::DEEPSEEK;
 
     #[\Override]
-    public function completion(History|string $input, CompletionConfig $config, array $tools = []): CompletionResponse
+    public function completion(History|string $input, CompletionConfig $config, ?array $tools = null): CompletionResponse
     {
         Assert::notEmpty($input);
         $this->buildReferences($tools);

src/Provider/Service/Client/GoogleClient.php

@@ -70,7 +70,7 @@ public function embeddings(string $prompt, EmbeddingConfig $config): EmbeddingRe
     }
 
     #[\Override]
-    public function completion(string|History $input, CompletionConfig $config, array $tools = []): CompletionResponse
+    public function completion(string|History $input, CompletionConfig $config, ?array $tools = null): CompletionResponse
     {
         try {
             $response = $this->http->request('POST', "models/{$config->model}:generateContent?key={$this->config->apiKey}", [

src/Provider/Service/Client/MistralClient.php

@@ -71,7 +71,7 @@ public function embeddings(string $prompt, EmbeddingConfig $config): EmbeddingRe
     }
 
     #[\Override]
-    public function completion(History|string $input, CompletionConfig $config, array $tools = []): CompletionResponse
+    public function completion(History|string $input, CompletionConfig $config, ?array $tools = null): CompletionResponse
     {
         Assert::notEmpty($input);
         $this->buildReferences($tools);

src/Provider/Service/Client/OllamaClient.php

@@ -69,7 +69,7 @@ public function embeddings(string $prompt, EmbeddingConfig $config): EmbeddingRe
     }
 
     #[\Override]
-    public function completion(History|string $input, CompletionConfig $config, array $tools = []): CompletionResponse
+    public function completion(History|string $input, CompletionConfig $config, ?array $tools = null): CompletionResponse
     {
         Assert::notEmpty($input);
         $this->buildReferences($tools);

src/Provider/Service/Client/OpenAIClient.php

@@ -74,7 +74,7 @@ public function embeddings(string $prompt, EmbeddingConfig $config): EmbeddingRe
     }
 
     #[\Override]
-    public function completion(History|string $input, CompletionConfig $config, array $tools = []): CompletionResponse
+    public function completion(History|string $input, CompletionConfig $config, ?array $tools = null): CompletionResponse
     {
         Assert::notEmpty($input);
         $this->buildReferences($tools);

src/Provider/Service/Common/ToolCallingSupport.php

@@ -32,15 +32,21 @@ trait ToolCallingSupport
      */
     private array $references = [];
 
-    public function buildReferences(array $tools): void
+    public function buildReferences(?array $tools = null): void
     {
-        foreach ($tools as $tool) {
-            $this->references[] = ToolRunner::build($tool, $this->provider);
+        if ($tools !== null) {
+            foreach ($tools as $tool) {
+                $this->references[] = ToolRunner::build($tool, $this->provider);
+            }
         }
     }
 
-    public function getToolDefinitions(): array
+    public function getToolDefinitions(): ?array
     {
+        if (empty($this->references)) {
+            return null;
+        }
+
         return \array_map(
             fn (ToolReference $reference): array => $reference->definition,
             $this->references

src/Provider/Service/HasCompletionSupport.php

@@ -30,10 +30,10 @@ interface HasCompletionSupport
      *
      * @param History|string $input The prompt to use for completion.
      * @param CompletionConfig $config The configuration to use for completion.
-     * @param array<object> $tools The tools to use for completion (optional).
+     * @param array|null $tools The tools to use for completion (optional).
      *
      * @throws ServiceIntegrationException when any error occurs during the request.
      * @throws \InvalidArgumentException when the prompt is empty.
      */
-    public function completion(History|string $input, CompletionConfig $config, array $tools = []): CompletionResponse;
+    public function completion(History|string $input, CompletionConfig $config, ?array $tools = null): CompletionResponse;
 }