Apply suggestions from code review

Author: OskarStark

src/platform/src/Bridge/Anthropic/Tests/Contract/AssistantMessageNormalizerTest.php

@@ -49,7 +49,18 @@ public function testNormalize(AssistantMessage $message, array $expectedOutput)
     }
 
     /**
-     * @return iterable<string, array{0: AssistantMessage, 1: array}>
+     * @return iterable<string, array{
+     *     0: AssistantMessage,
+     *     1: array{
+     *         role: 'assistant',
+     *         content: string|list<array{
+     *             type: 'tool_use',
+     *             id: string,
+     *             name: string,
+     *             input: array<string, mixed>|\stdClass
+     *         }>
+     *     }
+     * }>
      */
     public static function normalizeDataProvider(): iterable
     {

src/platform/src/Bridge/Bedrock/Tests/Nova/ContractTest.php

@@ -40,6 +40,9 @@ public function testConvert(MessageBag $bag, array $expected)
         $this->assertEquals($expected, $contract->createRequestPayload(new Nova('nova-pro'), $bag));
     }
 
+    /**
+     * @return iterable<array{0: MessageBag, 1: array}>
+     */
     public static function provideMessageBag(): iterable
     {
         yield 'simple text' => [

src/platform/src/Bridge/Gemini/Tests/Contract/AssistantMessageNormalizerTest.php

@@ -48,6 +48,9 @@ public function testNormalize(AssistantMessage $message, array $expectedOutput)
         $this->assertSame($expectedOutput, $normalized);
     }
 
+    /**
+     * @return iterable<string, array{AssistantMessage, array{text?: string, functionCall?: array{id: string, name: string, args?: mixed}}[]}>
+     */
     public static function normalizeDataProvider(): iterable
     {
         yield 'assistant message' => [

src/platform/src/Bridge/Gemini/Tests/Contract/MessageBagNormalizerTest.php

@@ -76,6 +76,9 @@ public function testNormalize(MessageBag $bag, array $expected)
         $this->assertEquals($expected, $normalized);
     }
 
+    /**
+     * @return iterable<array{0: MessageBag, 1: array}>
+     */
     public static function provideMessageBagData(): iterable
     {
         yield 'simple text' => [

src/platform/src/Bridge/HuggingFace/Tests/Contract/MessageBagNormalizerTest.php

@@ -73,6 +73,9 @@ public function testNormalize(MessageBag $bag, array $expected)
         $this->assertEquals($expected, $normalized);
     }
 
+    /**
+     * @return iterable<array{0: MessageBag, 1: array}>
+     */
     public static function provideMessageBagData(): iterable
     {
         yield 'simple text message' => [