refactor agent interface

Author: ilvalerione

src/Agent.php

@@ -22,12 +22,21 @@ class Agent implements AgentInterface
      */
     protected string $instructions;
 
+    /**
+     * @deprecated
+     */
     public function withInstructions(string $instructions): AgentInterface
     {
         $this->instructions = $instructions;
         return $this;
     }
 
+    public function setInstructions(string $instructions): AgentInterface
+    {
+        $this->instructions = $instructions;
+        return $this;
+    }
+
     public function instructions(): string
     {
         return 'Your are a helpful and friendly AI agent built with Neuron PHP framework.';

src/AgentInterface.php

@@ -18,8 +18,13 @@ public function withProvider(AIProviderInterface $provider): AgentInterface;
 
     public function resolveProvider(): AIProviderInterface;
 
+    /**
+     * @deprecated
+     */
     public function withInstructions(string $instructions): AgentInterface;
 
+    public function setInstructions(string $instructions): AgentInterface;
+
     public function instructions(): string;
 
     /**

src/HandleTools.php

@@ -112,7 +112,7 @@ public function bootstrapTools(): array
 
         $instructions = $this->removeDelimitedContent($this->resolveInstructions(), '<TOOLS-GUIDELINES>', '</TOOLS-GUIDELINES>');
         if ($guidelines !== []) {
-            $this->withInstructions(
+            $this->setInstructions(
                 $instructions.\PHP_EOL.'<TOOLS-GUIDELINES>'.\PHP_EOL.\implode(\PHP_EOL.\PHP_EOL, $guidelines).\PHP_EOL.'</TOOLS-GUIDELINES>'
             );
         }

src/RAG/RAG.php

@@ -109,7 +109,7 @@ public function withDocumentsContext(array $documents): AgentInterface
         }
         $newInstructions .= '</EXTRA-CONTEXT>';
 
-        $this->withInstructions(\trim($newInstructions));
+        $this->setInstructions(\trim($newInstructions));
 
         return $this;
     }

tests/NeuronAITest.php

@@ -50,7 +50,7 @@ public function instructions(): string
             }
         };
         $this->assertEquals('Hello', $agent->resolveInstructions());
-        $agent->withInstructions('Hello2');
+        $agent->setInstructions('Hello2');
         $this->assertEquals('Hello2', $agent->resolveInstructions());
     }