Adds an ability to merge options

src/Agent/AgentExecutor.php

@@ -9,6 +9,7 @@
 use LLM\Agents\LLM\ContextInterface;
 use LLM\Agents\LLM\LLMInterface;
 use LLM\Agents\LLM\OptionsFactoryInterface;
+use LLM\Agents\LLM\OptionsInterface;
 use LLM\Agents\LLM\Prompt\Chat\Prompt;
 use LLM\Agents\LLM\Prompt\Tool;
 use LLM\Agents\LLM\Response\ChatResponse;
@@ -34,6 +35,7 @@ public function execute(
  string $agent,
  string|\Stringable|Prompt $prompt,
  ?ContextInterface $context = null,
+ ?OptionsInterface $options = null,
  ?array $sessionContext = null,
  ): Execution {
  $agent = $this->agents->get($agent);
@@ -51,7 +53,7 @@ public function execute(
  $agent->getTools(),
  );
 
- $options = $this->optionsFactory
+ $defaultOptions = $this->optionsFactory
  ->create()
  ->with('model', $model->name)
  ->with(
@@ -67,6 +69,12 @@ public function execute(
  ),
  );
 
+ if ($options === null) {
+ $options = $defaultOptions;
+ } else {
+ $options = $defaultOptions->merge($options);
+ }
+
  foreach ($agent->getConfiguration() as $configuration) {
  $options = $options->with($configuration->key, $configuration->content);
  }

src/LLM/OptionsInterface.php

@@ -11,4 +11,6 @@ public function has(string $option): bool;
  public function get(string $option, mixed $default = null): mixed;
 
  public function with(string $option, mixed $value): static;
+
+ public function merge(OptionsInterface $options): static;
 }