feature #628 [Platform][DockerModelRunner] Add ModelNotFoundException (welcoMattic)

This PR was merged into the main branch.

Discussion
----------

[Platform][DockerModelRunner] Add `ModelNotFoundException`

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | yes<!-- please update src/**/CHANGELOG.md files -->
| Docs?         | no <!-- required for new features -->
| Issues        | Fix #... <!-- prefix each issue number with "Fix #", no need to create an issue if none exist, explain below instead -->
| License       | MIT

Following up #531

This PR introduce `ModelNotFoundException`, useful for local model runners that return an error due to a non-existing model locally (typo in name or never downloaded model for instance).

It must be used by Ollama and LmStudio bridges. PRs are welcome.

Commits
-------

3374b14 Add ModelNotFoundException

Author: OskarStark

src/platform/src/Bridge/DockerModelRunner/Completions/ResultConverter.php

@@ -14,6 +14,7 @@
 use Symfony\AI\Platform\Bridge\DockerModelRunner\Completions;
 use Symfony\AI\Platform\Exception\ContentFilterException;
 use Symfony\AI\Platform\Exception\ExceedContextSizeException;
+use Symfony\AI\Platform\Exception\ModelNotFoundException;
 use Symfony\AI\Platform\Exception\RuntimeException;
 use Symfony\AI\Platform\Model;
 use Symfony\AI\Platform\Result\ChoiceResult;
@@ -46,6 +47,11 @@ public function convert(RawResultInterface|RawHttpResult $result, array $options
             return new StreamResult($this->convertStream($result->getObject()));
         }
 
+        if (404 === $result->getObject()->getStatusCode()
+            && str_contains(strtolower($result->getObject()->getContent(false)), 'model not found')) {
+            throw new ModelNotFoundException($result->getObject()->getContent(false));
+        }
+
         $data = $result->getData();
 
         if (isset($data['error']['type']) && 'exceed_context_size_error' === $data['error']['type']) {

src/platform/src/Bridge/DockerModelRunner/Embeddings/ResultConverter.php

@@ -12,6 +12,7 @@
 namespace Symfony\AI\Platform\Bridge\DockerModelRunner\Embeddings;
 
 use Symfony\AI\Platform\Bridge\DockerModelRunner\Embeddings;
+use Symfony\AI\Platform\Exception\ModelNotFoundException;
 use Symfony\AI\Platform\Exception\RuntimeException;
 use Symfony\AI\Platform\Model;
 use Symfony\AI\Platform\Result\RawResultInterface;
@@ -31,6 +32,11 @@ public function supports(Model $model): bool
 
     public function convert(RawResultInterface $result, array $options = []): VectorResult
     {
+        if (404 === $result->getObject()->getStatusCode()
+            && str_contains(strtolower($result->getObject()->getContent(false)), 'model not found')) {
+            throw new ModelNotFoundException($result->getObject()->getContent(false));
+        }
+
         $data = $result->getData();
 
         if (!isset($data['data'])) {

src/platform/src/Exception/ExceedContextSizeException.php

@@ -14,6 +14,6 @@
 /**
  * @author Mathieu Santostefano <[email protected]>
  */
-class ExceedContextSizeException extends InvalidArgumentException
+class ExceedContextSizeException extends InvalidArgumentException implements ExceptionInterface
 {
 }

src/platform/src/Exception/ModelNotFoundException.php

@@ -0,0 +1,19 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\AI\Platform\Exception;
+
+/**
+ * @author Mathieu Santostefano <[email protected]>
+ */
+class ModelNotFoundException extends \InvalidArgumentException implements ExceptionInterface
+{
+}