refactor!: improve types in platform api (#376)

I was just tired of doing those `assert($response instanceof ...);`
statements
also resolves the special status of `AsyncResponse` by decoupling it
from the `ResponseInterface`

WDYT?

Author: chr-hertel

README.md

@@ -680,7 +680,7 @@ use PhpLlm\LlmChain\Platform\Bridge\OpenAI\Embeddings;
 
 $embeddings = new Embeddings($platform, Embeddings::TEXT_3_SMALL);
 
-$vectors = $platform->request($embeddings, $textInput)->getContent();
+$vectors = $platform->request($embeddings, $textInput)->asVectors();
 
 dump($vectors[0]->getData()); // Array of float values
 ```
@@ -703,7 +703,7 @@ foreach ($inputs as $input) {
 }
 
 foreach ($responses as $response) {
-    echo $response->getContent().PHP_EOL;
+    echo $response->asText().PHP_EOL;
 }
 ```
 
@@ -822,7 +822,7 @@ $response = $platform->request($model, $image, [
     'task' => Task::OBJECT_DETECTION, // defining a task is mandatory for internal request & response handling
 ]);
 
-dump($response->getContent());
+dump($response->asObject());
 ```
 
 #### Code Examples
@@ -867,7 +867,7 @@ $response = $platform->request($model, 'How many continents are there in the wor
     'task' => Task::Text2TextGeneration,
 ]);
 
-echo $response->getContent().PHP_EOL;
+echo $response->asText().PHP_EOL;
 ```
 
 #### Code Examples

examples/azure/audio-transcript.php

@@ -25,4 +25,4 @@
 
 $response = $platform->request($model, $file);
 
-echo $response->getContent().\PHP_EOL;
+echo $response->asText().\PHP_EOL;

examples/azure/embeddings.php

@@ -2,7 +2,6 @@
 
 use PhpLlm\LlmChain\Platform\Bridge\Azure\OpenAI\PlatformFactory;
 use PhpLlm\LlmChain\Platform\Bridge\OpenAI\Embeddings;
-use PhpLlm\LlmChain\Platform\Response\VectorResponse;
 use Symfony\Component\Dotenv\Dotenv;
 
 require_once dirname(__DIR__, 2).'/vendor/autoload.php';
@@ -28,6 +27,4 @@
     country was very peaceful and prosperous. The people lived happily ever after.
     TEXT);
 
-assert($response instanceof VectorResponse);
-
-echo 'Dimensions: '.$response->getContent()[0]->getDimensions().\PHP_EOL;
+echo 'Dimensions: '.$response->asVectors()[0]->getDimensions().\PHP_EOL;

examples/huggingface/audio-classification.php

@@ -22,4 +22,4 @@
     'task' => Task::AUDIO_CLASSIFICATION,
 ]);
 
-dump($response->getContent());
+dump($response->asObject());

examples/huggingface/automatic-speech-recognition.php

@@ -22,4 +22,4 @@
     'task' => Task::AUTOMATIC_SPEECH_RECOGNITION,
 ]);
 
-echo $response->getContent().\PHP_EOL;
+echo $response->asText().\PHP_EOL;

examples/huggingface/chat-completion.php

@@ -23,4 +23,4 @@
     'task' => Task::CHAT_COMPLETION,
 ]);
 
-echo $response->getContent().\PHP_EOL;
+echo $response->asText().\PHP_EOL;

examples/huggingface/feature-extraction.php

@@ -3,7 +3,6 @@
 use PhpLlm\LlmChain\Platform\Bridge\HuggingFace\PlatformFactory;
 use PhpLlm\LlmChain\Platform\Bridge\HuggingFace\Task;
 use PhpLlm\LlmChain\Platform\Model;
-use PhpLlm\LlmChain\Platform\Response\VectorResponse;
 use Symfony\Component\Dotenv\Dotenv;
 
 require_once dirname(__DIR__, 2).'/vendor/autoload.php';
@@ -21,6 +20,4 @@
     'task' => Task::FEATURE_EXTRACTION,
 ]);
 
-assert($response instanceof VectorResponse);
-
-echo 'Dimensions: '.$response->getContent()[0]->getDimensions().\PHP_EOL;
+echo 'Dimensions: '.$response->asVectors()[0]->getDimensions().\PHP_EOL;

examples/huggingface/fill-mask.php

@@ -20,4 +20,4 @@
     'task' => Task::FILL_MASK,
 ]);
 
-dump($response->getContent());
+dump($response->asObject());

examples/huggingface/image-classification.php

@@ -22,4 +22,4 @@
     'task' => Task::IMAGE_CLASSIFICATION,
 ]);
 
-dump($response->getContent());
+dump($response->asObject());

examples/huggingface/image-segmentation.php

@@ -22,4 +22,4 @@
     'task' => Task::IMAGE_SEGMENTATION,
 ]);
 
-dump($response->getContent());
+dump($response->asObject());