feat(agent): voice provider

Author: Guikingone

src/agent/src/Agent.php

@@ -33,20 +33,28 @@
      */
     private array $outputProcessors;
 
+    /**
+     * @var VoiceProviderInterface[]
+     */
+    private array $voiceProviders;
+
     /**
      * @param InputProcessorInterface[]  $inputProcessors
      * @param OutputProcessorInterface[] $outputProcessors
+     * @param VoiceProviderInterface[]   $voiceProviders
      * @param non-empty-string           $model
      */
     public function __construct(
         private PlatformInterface $platform,
         private string $model,
         iterable $inputProcessors = [],
         iterable $outputProcessors = [],
+        iterable $voiceProviders = [],
         private string $name = 'agent',
     ) {
         $this->inputProcessors = $this->initializeProcessors($inputProcessors, InputProcessorInterface::class);
         $this->outputProcessors = $this->initializeProcessors($outputProcessors, OutputProcessorInterface::class);
+        $this->voiceProviders = $this->initializeVoiceProviders($voiceProviders);
     }
 
     public function getModel(): string
@@ -79,6 +87,7 @@ public function call(MessageBag $messages, array $options = []): ResultInterface
 
         $output = new Output($model, $result, $messages, $options);
         array_map(fn (OutputProcessorInterface $processor) => $processor->processOutput($output), $this->outputProcessors);
+        array_map(static fn (VoiceProviderInterface $provider) => $provider->addVoice($output), $this->voiceProviders);
 
         return $output->getResult();
     }
@@ -103,4 +112,20 @@ private function initializeProcessors(iterable $processors, string $interface):
 
         return $processors instanceof \Traversable ? iterator_to_array($processors) : $processors;
     }
+
+    /**
+     * @param VoiceProviderInterface[] $providers
+     *
+     * @return InputProcessorInterface[]|OutputProcessorInterface[]
+     */
+    private function initializeVoiceProviders(iterable $providers): array
+    {
+        foreach ($providers as $provider) {
+            if (!$provider instanceof VoiceProviderInterface) {
+                throw new InvalidArgumentException(\sprintf('Voice provider "%s" must implement "%s".', $provider::class, VoiceProviderInterface::class));
+            }
+        }
+
+        return $providers instanceof \Traversable ? iterator_to_array($providers) : $providers;
+    }
 }

src/agent/src/VoiceProviderInterface.php

@@ -0,0 +1,20 @@
+<?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\Agent;
+
+/**
+ * @author Guillaume Loulier <[email protected]>
+ */
+interface VoiceProviderInterface
+{
+    public function addVoice(Output $output): void;
+}

src/platform/src/Result/VoiceAwareTrait.php

@@ -0,0 +1,20 @@
+<?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\Result;
+
+/**
+ * @author Guillaume Loulier <[email protected]>
+ */
+trait VoiceAwareTrait
+{
+
+}