linting

Author: ArnabChatterjee20k

docker-compose.yml

@@ -10,7 +10,6 @@ services:
       - ./src:/usr/src/code/src
       - ./tests:/usr/src/code/tests
       - ./phpunit.xml:/usr/src/code/phpunit.xml
-      - ./vendor:/usr/src/code/vendor
     environment:
       - TESTING=true
       - LLM_KEY_ANTHROPIC=${LLM_KEY_ANTHROPIC}

src/Agents/Adapter.php

@@ -104,7 +104,11 @@ abstract public function getSupportForEmbeddings(): bool;
      * Generate embedding for input text (must be implemented if getSupportForEmbeddings is true)
      *
      * @param  string  $text
-     * @return array
+     * @return array{
+     *     embedding: array<int, float>,
+     *     total_duration: int|null,
+     *     load_duration: int|null
+     * }
      */
     abstract public function embed(string $text): array;
 

src/Agents/Adapters/Anthropic.php

@@ -463,6 +463,14 @@ public function getSupportForEmbeddings(): bool
         return false;
     }
 
+    /**
+     * @param  string  $text
+     * @return array{
+     *     embedding: array<int, float>,
+     *     total_duration: int|null,
+     *     load_duration: int|null
+     * }
+     */
     public function embed(string $text): array
     {
         throw new \Exception('Embeddings are not supported for this adapter.');

src/Agents/Adapters/Deepseek.php

@@ -323,6 +323,14 @@ public function getSupportForEmbeddings(): bool
         return false;
     }
 
+    /**
+     * @param  string  $text
+     * @return array{
+     *     embedding: array<int, float>,
+     *     total_duration: int|null,
+     *     load_duration: int|null
+     * }
+     */
     public function embed(string $text): array
     {
         throw new \Exception('Embeddings are not supported for this adapter.');

src/Agents/Adapters/Gemini.php

@@ -354,6 +354,14 @@ public function getSupportForEmbeddings(): bool
         return false;
     }
 
+    /**
+     * @param  string  $text
+     * @return array{
+     *     embedding: array<int, float>,
+     *     total_duration: int|null,
+     *     load_duration: int|null
+     * }
+     */
     public function embed(string $text): array
     {
         throw new \Exception('Embeddings are not supported for this adapter.');

src/Agents/Adapters/Ollama.php

@@ -52,12 +52,11 @@ public function __construct(
      * Embedding generation (Ollama only supports embeddings, not chat)
      *
      * @param  string  $text
-     * @return array
-     *  [
-     *    'embedding' => array<float>,
-     *    'total_duration' => int,
-     *    'load_duration' => int
-     *  ]
+     * @return array{
+     *     embedding: array<int, float>,
+     *     total_duration: int|null,
+     *     load_duration: int|null
+     * }
      *
      * @throws \Exception
      */
@@ -132,7 +131,7 @@ public function setModel(string $model): self
     /**
      * Not applicable for embedding-only adapters.
      *
-     * @param  array  $messages
+     * @param  array<\Utopia\Agents\Message>  $messages
      * @param  callable|null  $listener
      *
      * @throws \Exception

src/Agents/Adapters/OpenAI.php

@@ -420,6 +420,14 @@ public function getSupportForEmbeddings(): bool
         return false;
     }
 
+    /**
+     * @param  string  $text
+     * @return array{
+     *     embedding: array<int, float>,
+     *     total_duration: int|null,
+     *     load_duration: int|null
+     * }
+     */
     public function embed(string $text): array
     {
         throw new \Exception('Embeddings are not supported for this adapter.');

src/Agents/Adapters/Perplexity.php

@@ -214,6 +214,14 @@ protected function sanitizeHtmlError(string $html): string
         return '(html_error) Received HTML error response from API';
     }
 
+    /**
+     * @param  string  $text
+     * @return array{
+     *     embedding: array<int, float>,
+     *     total_duration: int|null,
+     *     load_duration: int|null
+     * }
+     */
     public function embed(string $text): array
     {
         throw new \Exception('Embeddings are not supported for this adapter.');

src/Agents/Adapters/XAI.php

@@ -164,6 +164,14 @@ protected function formatErrorMessage($json): string
         return '('.$errorType.') '.$errorMessage;
     }
 
+    /**
+     * @param  string  $text
+     * @return array{
+     *     embedding: array<int, float>,
+     *     total_duration: int|null,
+     *     load_duration: int|null
+     * }
+     */
     public function embed(string $text): array
     {
         throw new \Exception('Embeddings are not supported for this adapter.');

src/Agents/Agent.php

@@ -141,7 +141,11 @@ public function setSchema(Schema $schema): self
      * Get embedding for input text using underlying adapter (if supported)
      *
      * @param  string  $text
-     * @return array
+     * @return array{
+     *     embedding: array<int, float>,
+     *     total_duration: int|null,
+     *     load_duration: int|null
+     * }
      *
      * @throws \Exception
      */
@@ -150,8 +154,7 @@ public function embed(string $text): array
         if (! $this->adapter->getSupportForEmbeddings()) {
             throw new \Exception('This adapter does not support embedding/embedding API.');
         }
-        // Delegates to adapter embed; guaranteed to exist for supporting adapters.
-        // @phpstan-ignore-next-line: mixed adapter return
+
         return $this->adapter->embed($text);
     }
 }